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to  check  it  for  consistency  and  completeness. -7  The  output  of  Phase  1 is 
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trainee  demands  into  classes  and  determines  the  amount  of  resources  used  by 
simulating  the  training  system.  - The  output  of  Phase  3 consists  of  source  and 
lag  records  which  indicate  the  occurence  of  trainee  matriculation,  lags  due 
to  lack  of  resources,  and  an  unused  resources  file."* Phase  4 computes  the 
amount  of  resources  used  by  comparing  the  unused  and  original  resources,  and 
then  prepares  an  economic  analysis  of  the  run.  Phase  5 processes  the  trainee 
source  and  lag  records  and  writes  a report  on  these  uses. 

The  TROLIE  program  provides  a quick-look  version  of  TRAM.  TROLIE 
provides  the  data  set  inputs  required  by  TRAM  Phase  4.  Phase  4 TRAM  then 
performs  the  same  economic  analysis,  

It  is  possible  to  write  a FORTRAN  program  with  variable  dimensions 
in  order  to  control  the  size  of  the  program  at  execution.  One  method  which 
is  frequently  used  is  to  create  a master  source  with  symbols  instead  of 
values,  which  are  replaced  by  numbers  using  a text  manipulation  program. 

Such  a system  is  used  in  TRAM.  The  text  manipulation  program  is  known  as 
VARY  and  is  documented  in  the  final  Section  of  this  report. 
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SUMMARY 

The  TRAM* is  a multiphase  set  of  computer  programs  which  models  a 
proposed  training  system  and  determines  resource  utilization,  scheduling 
problems  and  costs.  Figure  1.1  presents  the  overall  flow  diagram  which  de- 
picts each  program  within  TRAM  and  the  data  sets  associated  with  it.  Each 
program,  except  for  the  sorting  steps,  is  described  by  a user's  guide  and 
programmer's  guide.  Also  indicated  is  the  relationship  of  TROLIE**  , the 
quick-look  version  of  TRAM,  which  was  developed. 

Phase  1 of  the  TRAM  is  used  to  assemble  most  of  the  input  data  and 
to  check  it  for  consistency  and  completeness.  The  output  of  Phase  1 is 
normally  a tape  which  is  passed  to  Phase  2.  The  Phase  2 program  further 
checks  linkages  and  network  integrity  and  prepares  lists  of  names,  student 
demands,  trainee  source  lists  and  resource  lists.  Phase  3 resolves  the 
trainee  demands  into  classes  and  determines  the  amount  of  resources  used  by 
simulating  the  training  system.  The  output  of  Phase  3 consists  of  source 
and  lag  records  which  indicate  the  occurrence  of  trainee  matriculation,  lags 
due  to  lack  of  resources,  and  an  unused  resources  file.  Phase  4 computes  the 
amount  of  resources  used  by  comparing'  the  unused  and  original  resources,  and 
then  prepares  an  economic  analysis  of  the  run.  Phase  5 processes  the  trainee 
source  and  lag  records  and  writes  a report  on  these  uses. 


The  TROLIE  program  provides  a quick- look  version  of  TRAM.  TROLIE 
provides  the  data  set  inputs  required  by  TRAM  Phase  4.  Phase  4 TRAM  then 
performs  the  same  economic  analysis. 

It  is  possible  to  write  a FORTRAN  program  with  variable  dimensions 
in  order  to  control  the  size  of  the  program  at  execution.  One  method  which 
is  frequently  used  is  to  create. a master  source  with  symbols  instead  of 
values,  which  are  replaced  by  numbers  using  a text  manipulation  program. 

Such  a system  is  used  in  TRAM.  The  text  manipulation  program  is  known  as 
VARY  and  is  documented  in  the  final  Section  of  this  report. 


The  following  Sections  describe  the  phases  of  TRAM,  TROLIE,  and 

VARY. 


* Training  Resources  Analytic  Model 

**  Training  Resources  Organized  for  Logical  Integration  of  Expenses 
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The  purpose  of  phase  1 is  to  read  the  user  inputs  and  convert  them  to 
the  internal  format  required  for  phase  2.  It  also  tests  the  inputs  for  validity 
and  provides  the  necessary  outputs  to  document  the  run. 


Description 


Phase  1 performs  the  following  functions: 


• reads  the  input  cards  and  prints  them 

• checks  all  values  for  validity 

• prints  formatted  tables  of  the  inputs 

• replaces  user  assigned  names  with  an  internal  ID  number 

• plots  a course  block  diagram 

• sorts  the  data  records  and  writes  them  onto  unit  10  for 

phase  2 


The  values  from  each  input  card  are  printed  as  they  are  read.  Also, 
each  numeric  value  is  tested  against  a range  of  acceptable  values  to  see  if  it 
is  valid.  If  it  is  not,  a diagnostic  message  is  printed,  which  will  appear  im- 
mediately after  the  card  on  the  input  card  listing. 

After  all  inputs  have  been  read,  they  may  be  optionally  re-printed  in 
formatted  tables.  The  purpose  of  this  printout  is  to  show  all  the  inputs  in  an 
easily  readable  form. 


The  next  processing  step  generates  a table  of  all  user  assigned  names, 
and  replaces  all  references  to  these  names  with  internal  ID  numbers.  It  is  at 
this  time  that  undefined  or  multiply  defined  names  are  detected  and  flagged. 

If  no  errors  have  been  detected  up  to  this  point,  the  course  block 
diagram  is  plotted  (optional).  Additional  error  messages  are  printed  if  the 
processing  blocks  are  not  in  the  proper  order  for  plotting. 
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1.3.1  General  Coding  Information 

t 


The  input  cards  for  the  TRAM  model  have  fixed  format  fields, 
and  a separate  card  is  provided  for  each  different  type  of  information.  Coding 
forms  for  each  of  these  input  cards  are  shown  in  Section  1.5, 


All  cards  have  a card  name  field,  which  is  used  to  identify 
the  card  type.  Although  the  different  card  types  contain  different  information, 
most  of  them  conform  to  a standard  field  layout.  This  consists  of  the  card  name 
field  in  columns  1-10,  followed  by  two  ten-column  character  data  fields  and  ten 
five-column  numeric  data  fields.  All  numeric  data  are  read  in  integer  format. 


Variables  whose  value  can  take  on  non-integral  values  are  read  with  an  implied 
decimal  point.  These  values  arc  converted  internally,  using  the  position  of  the 
implied  decimal  point  shown  on  the  coding  forms.  For  example,  an  alert  ratio  of 
.57  would  be  coded  as  57  on  the  airbase  event  card.  Character  data  are  left  jus- 
tified, and  numeric  data  are  right  justified. 

Cards  that  do  not  conform  to  the  standard  field  layout  (TASK, 
RUB,  RUDB) , must  be  preceded  by  a set  header  card.  This  card  identifies  the  type 
of  cards  that  are  to  follow.  Note  that  these  non-standard  cards  have  a blank 
card  name  field,  since  the  card  type  is  identified  by  the  header  card.  Each  set 
is  terminated  by  a SETEND  card. 

Some  input  cards  require  additional  continuation  cards.  Such 
cards  have  parameters  to  give  the  number  of  each  type  of  card  which  is  to  follow 
it.  The  formats  for  these  additional  cards  are  shown  on  the  same  coding  form  as 
the  header  card  so  that  they  may  easily  be  coded  in  the  proper  sequence.  Note 
that  these  continuation  cards  also  have  blank  card  name  fields,  since  the  card 
type  is  identified  by  the  header  card. 
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In  general,  these  cards,  or  groups  of  cards,  can  be  coded 
in  any  order.  The  only  exception  to  this  is  the  course  and  the  processing 
block  cards.  The  processing  blocks  for  each  course  must  follow  the  course 
card.  Also,  the  processing  blocks  within  a course  must  start  with  the  grad- 
uation block  and  proceed  towards  matriculation.  This  is  because  the  position 
of  each  processing  block  is  given  as  an  offset  from  the  block  connected  to  it 
on  the  right.  If  there  is  more  than  one  block  to  the  right,  as  in  the  case 
of  fan-outs,  the  first  one  encountered  is  the  one  used  as  the  reference  posi- 
tion. 


The  input  deck  must  be  ended  with  an  end  card,  which  consists 
of  the  word  "END"  in  the  first  field. 

1.3.2  TRAM  Input  Descriptions 
Time  Units  in  TRAM 

Time  in  TRAM  appears  in  several  ways.  The  basic  unit  of  time 
is  the  calendar  unit  (CU) . The  size  of  the  calendar  unit  is  determined  by  the 
number  of  CUs  in  a year.  If  one  CU  is  equal  to  a day,  and  a 7 day  week  is  de- 
sired, then  there  are  365  CUs  in  a year.  But  if  a 6 day  week  is  desired,  then 
there  are  only  6 x 52  * 312  CUs  in  a year.  All  events  in  the  program  are  expressed 
in  CUs. 


2 and  4. 


The  year  is  a second  unit  of  time  which  is  used  in  TRAM  - Phases 


Resource  and  source  use  is  accounted  for  in  "buckets".  A bucket 
represents  the  short  term  planning  horizon  for  the  resource  or  source  use. 

Time  as  a unit  of  a resource  use  is  independent  of  CUs.  Con- 
sider our  312  CU  year.  A simulator  operated  10  hours  per  day,  7 days  per  week, 
could  yield  3650  hours  of  training  per  year  with  no  conflict  in  the  definition  of 
the  CU. 
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?es  of  Trainees  in  TRAM 


Trainees  are  of  four  types:  pilots,  copilots,  0S0  and  DSO. 

These  are  encoded  as  8,  4,  2,  1,  respectively.  Normally  aircrews  are  trained 
in  complete  sets.  However,  provision  is  made  for  having  an  independent  attri- 
tion of  each  type  of  trainee.  If  a different  attrition  formulation  is  used, 
or  if  there  are  unbalanced  initial  inventories  at  the  airbases,  an  unbalanced 
number  of  trainees  will  be  required.  Trainees  that  are  not  a part  of  a complete 
aircrew  are  labeled  as  extras,  as  opposed  to  normal  trainees.  Special  tasks  can 
be  defined  for  these  extra  trainees  (see  task  type  field  on  task  description 
card. ) 

The  following  paragraphs  describe  the  input  data  for  TRAM  in 
an  appropriate  order  for  input  to  the  program. 

Control  Card 

The  control  card  must  be  the  first  card  of  the  input  deck. 

Airbase  Inventory  Cards  (One  and  only  one  per  airbase) 

These  cards  serve  to  name  the  airbases.  If  desired,  an  ini- 
tial inventory  of  aircraft  and  aircrews  can  be  placed  at  the  airbases.  The  quan- 
tity of  aircraft  and  aircrews  is  assumed  to  be  constant  for  all  time  previous  to 
the  beginning  of  a run  for  the  purposes  of  attrition  calculations. 

Airbase  Event  Cards  (One  or  more  per  airbase) 

At  least  one  event  must  be  provided  for  each  airbase.  In  this 
way,  the  crew  ratio,  alert  ratio  and  crew  yield  (hours/crew/week)  can  be  introduced. 
If  the  rules  for  manning  a base  change,  for  instance  if  the  crew  ratio  changes,  if 
the  PMT  changes,  or  if  a new  CCTS  is  introduced,  airbase  events  must  be  provided 
for  the  changes . ' 

Aircraft  Delivery  Cards 


Aircraft  delivery  cards  are  required  only  if  the  initial  inven- 
tory at  an  airbase  changes.  Delivery  of  an  aircraft  is  not  an  "airbase  event". 


CCTS  Cards 

CCTS  cards  are  used  to  assign  CCTS  courses  to  Demands  for 
trainees.  At  least  one  CCTS  card  must  be  provided  for  each  crewmember  for  each 
airbase  with  an  inventory  of  aircraft.  The  CCTS  courses  which  support  an  air- 
base can  change,  or  multiple  CCTS  courses  can  be  specified  through  the  ratio 
parameter  operating  in  conjunction  with  airbase  events.  The  total  proportion 
of  each  crewmember  from  any  base  must  be  100. 

PMT  Group  Cards 

A PMT  group  is  a set  of  PMT  courses  which  run  simultaneously. 
Typically,  a PMT  group  is  the  courses  required  to  provide  recurrent  training  and 
evaluation  of  the  crewmembers.  If  PMT  is  conducted  for  complete  crews  only,  then 
only  the  pilot  needs  to  be  modeled.  The  remaining  crewmembers  can  be  ignored,  if 
the  resource  use  which  they  would  normally  introduce  is  attributed  to  the  pilots, 
and  if  there  is  no  chance  of  having  more  of  one  type  crewmember  than  another,  as 
a result  of  unbalanced  initial  inventories.  The  period  is  the  frequency  (CUs  per 
training  period)  that  crews  must  return  for  PMT  training  within  the  given  group. 
PMT  training  can  change  by  means  of  the  airbase  event  reference. 

PMT  Cards 

PMT  cards  follow  their  associated  PMT  Group  card.  These  cards 
are  used  to  define  the  PMT  courses  in  a PMT  Group.  Trainees  can  be  apportioned 
among  PMT  courses  via  the  ratio  parameter.  The  total  proportion  must  be  100  for 
each  crewmember  in  each  PMT  group.  The  time  lost  parameter  is  the  total  time 
away  from  the  airbase  less  the  time  actually  spent  in  the  course,  normally  the 
2-way  transportation  delay. 

Training  Course  Cards 

A course  is  the  instruction  required  to  train  a given  crewmem- 
ber. As  noted  above,  more  than  one  course  can  be  provided  so  that  any  combination 
of  courses  can  be  called  upon  to  support  any  time-varying  combination  of  airbases. 

A course  is  made  up  of  any  number  of  tracks.  Hach  track  leads  to  a unique  source 
of  trainees.  Training  course  cards  are  header  cards  for  the  processing  block  cards 
which  make  up  a course.  The  course  has  potential  graduations  starting  at  the  given 
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date  and  extending  regularly  toward  the  end  of  the  course  with  the  given  period. 
Within  the  period,  sufficient  graduations  are  scheduled  to  distribute  the  grad- 
uates as  evenly  as  possible.  The  minimum  number  of  graduations  is  scheduled  as 
determined  from  the  maximum  class  size.  If  at  least  one  trainee  is  required  in 
the  period,  a graduation  is  scheduled. 


Processing  Block  Cards 

A processing  block  is  akin  to  an  instructional  block.  The 
trainees  are  processed  by  the  block  in  the  sense  that  when  trainees  are  present, 
action  is  taken  by  the  program.  The  processing  block  cards  are  header  cards  for 
transfer  cards  and  task  cards.  If  trainees  must  have  other  trainees  present, 
such  as  when  flying  an  aircraft,  synchronization  and  correlation  loops  are  defined. 
Such  a loop  is  formed  by  a scries  of  block  references.  Block  A points  to  Block  B 
which  points  to  Block  C,  etc.  until  the  final  block  in  the  loop,  say  Block  G,  com- 
pletes the  loop  by  pointing  back  to  Block  A.  Synchronization  means  that  all  crew- 
members from  a given  class  are  present  in  the  appropriate  blocks  of  the  loop. 
Correlation  means  that  a trainee  is  in  a block  in  the  loop  for  each  of  the  courses 
in  the  loop.  Synchronization  is  used  when  one  wishes  to  train  a crew  that  will 
stay  together  and  ultimately  be  assigned  to  the  same  airbase.  Correlation  is  a 
much  weaker  constraint.  Correlation  is  used  when  one  wishes  to  have  each  position 
manned.  Synchronization,  since  it  requires  a complete  aircrew,  can  only  be  de- 
fined for  portions  of  the  training  program  in  which  all  crewmembers  are  being 
trained.  Thus  a synchronization  loop  must  include  a block  from  all  of  the  tracks 
in  the  courses  which  it  links. 


Blocks  must  be  numbered  uniquely  in  a course  but  need  not  fol- 
low any  sequence.  The  bxock  duration  is  the  expected  time  required  to  complete 
the  instruction  within  the  block.  The  location  information  is  used  for  plotting. 
The  location  values  are  relative  to  the  next  block  in  the  course.  Blocks  have  a 
standard  size  of  1"  (height-y)  by  1.4"  (width-x) . Blocks  are  assumed  to  be  placed 
in  the  input  in  order  from  graduation  (which  is  normally  on  the  right  of  the  plot) 
toward  matriculation  (on  the  left).  If  this  order  is  not  maintained,  one  to  five 
transfer  cards  are  required. 


The  special  value  of  -1  transfers  is  used  to  indicate  that  a 
processing  block  has  a source  task.  The  special  value  of  0 transfers  indicates 
that  the  assumed  sequencing  is  used.  Up  to  five  tasks  can  be  specified  for  each 
block.  Block  priority  is  not  currently  implemented. 


Transfer  Cards 


Transfer  cards  immediately  follow  processing  block  cards  to 
which  they  refer.  Transfer  cards  are  used  (1)  whenever  the  processing  block  card 
which  follows  a given  processing  block  card  is  not  the  immediate  predecessor  block 
in  the  course,  and  (2)  whenever  more  than  one  block  precedes  a given  block  (i.e., 
when  tracks  split  off  from  common  segments  of  a course.)  The  priority  of  the 
transfer  indicates  the  preference  of  the  source  or  sources  at  the  end  of  the  branch 
(higher  numeric  value  indicates  higher  priority.)  Priorities  of  secondary,  ter- 
tiary etc.,  branches  have  secondary,  tertiary,  etc.,  effects  on  the  calculation  of 
priority.  The  ratio  parameter  is  used  to  apportion  trainees  within  a given  pri- 
ority level.  Thus  it  is  the  transfer  cards  which  implement  source  preferences. 

The  program  attempts  to  obtain  all  trainee  requirements  from  the  highest  priority 
sources  until  they  are  exhausted.  It  then  goes  to  the  next  highest  priority  source, 
etc.  Within  a given  priority  level  the  given  proportion  will  only  be  preserved  if 
(1)  the  sources  can  support  the  damands  and  if  (2)  the  class  is  capable  of  splitting 
(i.e.,  a class  of  1 cannot  split,  a class  of  2 cannot  split  3 ways,  etc.). 


In  Case  1 the  program  uses  sources  until  all  sources  at  a given 
level  are  exhausted  before  calling  on  lower  priority  sources.  In  Case  2 the  first, 
highest  priority  branches  are  taken. 
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A task  card  is 

The  kinds  of  tasks  defined  are: 

required  for  each  task  in  a processing  block 

SYNCH 

Synchronize 

CORRELATE 

Correlate 

USERESRCE 

Use  of  resources 

SOURCE 

Get  trainees  from  a source 

SCATSA 

Split  classes  according  to  source 

availability 

A given  task  must  be  defined  only  once.  It  can  be  defined 
in  place  behind  the  processing  block  or  in  a separate  set  of  task  description 
cards  following  a task  header  card.  In  this  way,  a single  task  definition  can 
serve  several  processing  blocks.  Once  a task  is  defined,  all  other  processing 
blocks  using  the  task  invoke  it  by  including  a card  with  the  task  name  only. 

SYNCH  Function 

A single  task  should  be  defined  whose  function  is  to  imple- 
ment the  synchronization  function.  A suitable  task  name  is  SYNCH. 

CORRELATE  Function 

A single  task  should  be  defined  whose  function  is  to  imple- 
ment correlation.  If  correlation  is  not  possible  within  a given  period  input 
in  phase  3,  an  extras  task  is  activated  if  it  exists.  Correlation  can  occur 
using  normal  or  extras  trainees. 

SCATSA  Function  - Split  Classes  According  to  Source  Availability 

This  task  is  required  once  and  only  once  for  any  course  that 
has  more  than  one  track.  The  SCATSA  task  is  placed  in  the  first  processing  block 
that  contains  all  tracks  in  the  course,  that  is,  in  the  processing  block  furthest 
from  the  graduation  block. 
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USERESRCE  Function 


A USERESRCE  function  task  is  required  to  expend  resources. 
This  is  accomplished  through  the  RUB  - Resource  Use  Block.  USERESRCE  tasks 
can  be  either  normal  - (all  trainees  use  the  resources)  or  extras  - (for  extra 
and  uncorrelatable  trainees.)  Task  names  for  USERESRCE  tasks  are  conveneintly 
chosen  to  be  the  same  as  or  related  to  their  RUB  and  ultimately  the  RIJDBs. 


SOURCE  Function 

The  source  task  provides  a means  for  identifying  the  source 
of  a track.  A unique  source  task  must  be  defined  for  each  source.  Associated 
with  the  source  task  are  RUB,  RUDB,  and  SOURCE  cards.  (RUDB  cards  for  sources 
contain  only  a name  and  resource  field.)  Thus,  sources  of  trainees  are  treated 
almost  like  resources.  A suitable  name  for  the  RUB  and  RUDB  is  the  source  name. 
If  a processing  block  has  a source  task,  the  number  of  transfers  is  set  to  -1  to 
indicate  that  this  is  the  end  of  the  track.  Transfer  cards  are  not  required  for 
such  a processing  block. 


RUB  Cards 

Resource  Utilization  Block  cards  are  read  in  sets  preceded  by 
a RUB  header  card.  Up  to  6 Resource  Utilization  Description  Blocks  (RUDBs)  are 
referenced  by  a given  RUB.  RUBs  are  conveniently  named  to  indicate  the  RUDBs  to 
which  they  refer.  The  purpose  of  the  extra  layer  of  referencing  is  to  allow  for 
an  essentially  unlimited  number  of  resource  usages  through  the  secondary  RUB  para- 
meter in  the  RUDB  card. 

RUDB  Cards 

Resource  Utilization  Description  Block  cards  are  used  to  indi- 
cate resource  use.  Resources  named  must  be  defined  by  an  inventory  card.  When  a 
class  of  trainees  invokes  an  RUDB  the  amount  of  use  can  be  dependent  upon  the  class 
(i.e.,  a classioom  and  instructor)  or  trainee  (i.e.,  a 1-position  simulator).  The 
use  of  the  resource  can  be  concentrated  at  the  end  of  the  processing  block  (INSTANT), 
occur  uniformly  throughout  the  duration  of  the  processing  block  (UNIFORM)  or  in  any 
feasible  manner  (ARBITRARY).  ARBITRARY  usage  will  concentrate  the  use  as  much  as 
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possible  at  the  latest  time  in  the  processing  block,  an  algorithm  logic  that 
tends  to  maximize  earlier  availability  of  the  resource.  Secondary  RUBs  are 
automatically  invoked  when  the  given  RUDB  is  invoked.  An  exceedingly  long 
string  of  RUB-RUDB-RUB  etc.'s  is  possible.  Alternate  RUDBs  are  invoked  to  the 
extent  that  a given  RUDB  is  not  feasible.  That  is,  the  primary  resource  is 
used  until  it  is  exhausted  before  the  alternate  resource  is  used. 

Resources  are  provided  in  units.  Typically  these  units  have 
the  dimension  of  time  in  a facility  but  other  units  are  possible,  such  as  fuel 
if  it  is  to  be  accounted  separately.  Units  should  be  defined  to  assure  that 
only  integral  values  are  required. 

Resource  Inventory  Cards  and  Source  of  Trainee  Cards 

These  cards  are  used  to  define  the  sources  and  resources  and 
their  availability  using  the  uniform  generating  function  (the  only  one  provided.) 
The  parameters  are  the  number  of  units  available  per  bucket  and  the  size  of  the 
bucket  in  calendar  units  (see  above  paragraph  on  RUDBs.)  The  first  source  of 
trainees  must  have  the  name  COPILOTS  even  if  there  is  no  copilot  recovery. 

1 ; 4 Outputs 

Input  Card  Listing 

This  listing  shows  the  values  exactly  as  they  are  read  from  each  card. 
Field  numbers  are  marked  across  the  top  of  the  page  for  reference  by  error  mes- 
sages . These  fields  correspond  to  five  card  columns  Character  data  are  spread 
across  two  such  fields,  and  would  be  referred  to  by  the  number  of  the  second 
field.  Also,  card  sequence  numbers  are  printed  for  later  reference  by  error 
messages.  This  listing  is  always  printed. 

Formatted  Input  Tables 

These  tables  duplicate  the  information  shown  by  the  input  card,,  listing, 
but  present  it  in  a conveniently  readable  form.  All  variables  are  identified  by 
column  titles,  and  the  meanings  of  integer  codes  are  printed  rather  than  the  codes 
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themselves.  Also,  these  values  will  show  the  results  of  any  input  conversion 
that  was  done.  The  user  may  suppress  this  listing  by  use  of  the  input  routine 
control  card. 

Course  Block  Diagram 


This  plot  shows  the  structure  of  the  courses  by  displaying  each  pro- 
cessing block  in  the  course  as  a rectangle,  with  the  flow  of  students  shown  by 
connecting  lines  from  one  processing  block  to  the  next.  Inside  each  rectangle, 
the  block  number,  block  name,  synchronize-correlate  reference  (if  any),  and  task 
names  are  shown.  The  course  name  is  plotted  above  each  graduation  block.  The 
input  routine  control  card  specifies  if  this  plot  is  to  be  produced. 
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1.7  INPUT  ROUTINE  ERROR  MESSAGES 

ABOVE  CARD  IS  OUT  OF  SEQUENCE 

A card  which  requires  a header  card  to  precede  it,  was  encountered 
before  the  header  card.  (From  INPUT) 

ERROR  AT  CARD  NUMBER  XX,  BLOCK  NUMBER  SYNCHRONIZED  TO  IS  INVALID  - YY 

A processing  block  card  specifies  a synchronize  or  correlate  reference 
to  another  block  number  which  does  not  exist  in  the  specified  course. 
The  card  sequence  number  of  the  error  is  given  by  XX,  and  the  invalid 
block  number  is  given  by  YY.  (From  PR0CB2) 

ERROR  AT  CARD  NUMBER  XX,  INVALID  TRANSFER  BLOCK  NUMBER  - YY 

The  processing  block  specified  by  card  number  XX  specifies  a transfer 
from  a processing  block  which  was  never  defined  within  that  course. 

The  invalid  block  number  is  given  by  YY . (From  PR0CB2) 

ERROR  IN  SUBROUTINE  IPLOT  - INSUFFICIENT  STORAGE  AVAILABLE  TO  DO  BLOCK  DIAGRAM 
PLOT 

The  quantity  of  inputs  was  great  enough  so  that  there  is  not  enough 
storage  left  for  the  plot  routines  work  areas.  The  program  will  con- 
tinue, but  no  plot  will  be  produced.  (From  IPLOT) 

ERROR  IN  SUBROUTINE  PLOTB  - BLOCK  NUMBER  XX  WAS  ENCOUNTERED  BEFORE  ANY  BLOCK 
SPECIFYING  A TRANSFER  FROM  IT 

The  processing  blocks  are  out  of  sequence.  The  position  of  each 
processing  block  is  specified  as  an  offset  from  the  block  to  the 
right  of  it  (toward  graduation).  Therefore,  each  time  a processing 
block  is  specified,  another  block  must  have  already  specified  a 
transfer  from  it.  (From  PLOTB) 
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PHASE  2 


PURPOSE 


Phase  2 reformats  the  data  passed  from  Phase  1,  placing  the  data  into 
a format  usable  by  Phase  3.  Phase  2 conducts  data  validity  tests  in  addition  to 
those  performed  during  Phase  1.  Phase  2 calculates,  based  on  input  parameters, 
copilots  recoverable  and  graduation  demands  for  each  air  base. 


DESCRIPTION 


Phase  2 performs  five  functions: 


reformats  name  tables 


reformats  and  tests  course  decription  blocks 
calculates  attrition  and  graduation  demands  for  each  air  base 
calculates  the  number  of  copilots  recoverable 
generates  source  and  resource  files 


The  name  table  contains  the  names  of  all  functions,  blocks,  courses, 
etc,  that  were  specified  in  the  input  to  Phase  1.  These  tables  are  used  in  Phases  2 
and  3 for  printing  reports.  Phase  2 places  these  name  tables  in  a format  that  can 
be  used  by  Phase  2 and  Phase  3. 


The  course  description  blocks  are  reformatted  by  replacing  block  num- 
bers with  pointers  to  the  block  storage  locations.  In  addition,  structures  formed 
by  course  description  blocks  are  examined  to  detect  illegal  conditions.  Synchro- 
nization and  correlation  loops  must  form  a circular  list  of  length  no  larger  than 
a preset  maximum.  Course  tracks  and  paths  through  RUB-RUDB  blocks  must  be  of  a 
limited  length  and  must  not  loop  back  into  themselves  (i.e.  they  must  not  form 
circular  structures.) 


The  air  base  calculations  include  the  following:  demands  based  on  ini- 

tial inventory  of  aircraft,  initial  inventory  of  crew  members,  and  aircraft  deliv- 
eries, attrition  and  demands  due  to  attrition;  and  demands  due  to  proficiency  main- 
tenance training  requirements.  A test  is  made  to  insure  proficiency  maintenance 
training  is  feasible.  The  demand  file  is  sorted  by  decreasing  time. 
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ERROR  IN  SUBROUTINE  PLOTB  - INSUFFICIENT  WORKING  STORAGE  AVAILABLE  - 
FLOW  ARROWS  WILL  BE  OMITTED 

The  course  is  structured  so  that  many  processing  blocks  specify 
transfers  from  block  numbers  which  are  not  defined.  This  message 
is  printed  when  the  plot  routine  runs  out  of  room  to  store  the  ref- 
erences until  they  are  defined.  Usually  the  processing  blocks  can 
be  specified  in  a different  order  to  reduce  the  number  of  such  ref- 
erences, but  if  no l,  the  program  will  have  to  be  recompiled  to  make 
storage  available.  (From  PLOTB) 

ERROR  ON  CARD  NUMBER  XX,  BLOCK  NUMBER  YY  HAS  BEEN  PREVIOUSLY  DEFINED 

Two  processing  blocks  with  the  same  number  have  been  defined  within 
the  same  course.  (Prom  PR0CB1) 

ERROR  ON  CARD  NUMBER  XX,  DATA  BLOCK  NAME  PREVIOUSLY  DEFINED  - YY 

Card  number  XX  attempts  to  define  a data  block  with  the  name  YY,  but 
the  same  name  has  already  been  used  for  another  block.  (From  NAME1) 

ERROR  ON  CARD  NUMBER  XX,  INVALID  REFERENCE  - YY 

The  card  has  referenced  another  data  block  which  was  never  defined. 
The  undefined  block  name  or  processing  block  number  is  given  by  YY. 
(From  REPLC1 , REPLC2) 

INSUFFICIENT  STORAGE  AVAILABLE  FOR  INPUTS 

The  amount  of  input  data  is  greater  than  the  amount  the  program  can 
store.  The  program  will  have  to  be  re-compiled  with  more  storage 
made  available  to  it.  (From  INPUT) 


INSUFFICIENT  STORAGE  AVAILABLE  TO  CONSTRUCT  BLOCK  NAME  TABLE 


The  quantity  of  input  data 
storage  available  to  do  the 
The  program  will  have  to  be 
(From  NAME1 , MAIN) 


is  large  enough  so  that  there  is  not  enough 
cross  referencing  of  da  la  block  name., 
re-compiled  to  make  more  storage  available. 
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E 

INVALID  CARD  NAME  ON  ABOVE  CARD 

This  message  appears  in  the  input  card  listing.  The  card  printed 
immediately  above  the  message  has  a card  name  which  is  not  recog- 
nized by  the  program  (card  name  field  is  columns  1-10.)  (From  INPUT) 

INVALID  VALUE  IN  FIELD  NUMBER  XX 

The  card  printed  immediately  above  this  error  message  contains  a numeric 
value  which  is  outside  the  range  allowed  for  that  value.  The  field 
number  XX,  refers  to  the  field  number  marking  at  the  top  of  the  input 
card  listing.  (From  TEST) 

RESOURCE  NAME  MUST  NOT  BE  BLANK 

The  RUDB  card  which  is  printed  above  this  error  message  does  not  have 
a resource  name  specified.  (From  INPUT) 
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It  may  be  relevant  to  point  out  that,  at  this  point,  training  demands 
remain  in  unquantized  torm;  quantization  to  integer  numbers  of  people  is  a Phase 
3 task. 


The  number  of  copilots  recoverable  is  calculated  from  the  copilot  attri- 
tion information.  The  copilots  recoverable  are  passed  to  Phase  3 as  a source  on 
the  source  file. 

Source  and  resource  files  are  generated  from  the  source  and  resource 
parameters  passed  from  Phase  1.  Phase  2 uses  the  generating  function  to  partition 

the  sources  and  resources  into  intervals.  The  source  and  resource  files  are  sorted 
by  decreasing  time  and  increasing  source  or  resource  number. 

In  addition  to  these  five  functions,  Phase  2 passes  selected  parameters 
to  Phases  3 and  4. 


INPUT 


Phase  3 reads  a binary  file  (unit  10)  by  Phase  2 and 
card  (from  unit  5.) 


one  control 


The  format  of  this  control  card  is  given  on  the  following  page. 
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CONTENTS 
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0 

0 

0 
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1 

1-3 

F3.0 

Percentage  of  Pilot  Attrition  Per  Year 

2 

5-7 

F3.0 

Percentage  of  Copilot  Attrition  Per  Year 

3 

9-11 

F3.0 

Percentage  of  0S0  Attrition  Per  Year 

4 

13-15 

F3.0 

Percentage  of  DSO  Attrition  t>er  Year 

5 

17-21 

15 

Delay  Time  For  Pilots  That  Are  Attrited 
(Calendar  Units) 

6 

23-27 

15 

Delay  Time  For  Copilots  That  Are  Attrited 
(Calendar  Units) 

7 

29-33 

15 

Delay  Time  For  0S0  That  Are  Attrited 
(Calendar  Units) 

8 

35-39 

15 

Delay  Time  For  DSO  That  Are  Attrited 
(Calendar  Units) 

9 

41-43 

F3.0 

Percentage  of  Attrited  Copilots  Recoverable 

10 

45-49 

15 

Length  of  Time  a Copilot  Can  Be  Recovered 
(Calendar  Units) 

11 

51-55 

15 

End  of  Simulation  Time  (Calendar  Units) 

12 

57-61 

15 

Bucket  Size  for  Performing  Air  Base  Calcu- 
lations (Calendar  Units) 

13 

63-67 

15 

Calendar  Units  Per  Year 

14 
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The  attrition  rate  of  each  type  of  crewmember  is  expressed  as  a per- 
centage of  the  number  of  crewmembers  at  each  base  at  a given  time,  relative  to 
the  number  at  a "previous"  time.  The  difference  in  the  present  time  and  "pre- 
vious" or  reference  time  is,  by  definition,  the  attrition  delay  time.  Each 
crewmember  type  has  an  independent  attrition  delay  time  and  attrition  rate. 
Attrition  is  computed  one  base  at  a time. 

The  number  of  copilots  recoverable  at  any  time  is  equal  to  the  number 
of  copilots  attrited  at  all  air  bases  multiplied  by  the  percentage  of  copilots 
recoverable.  These  copilots  are  considered  to  be  available,  but  the  number  of 
calendar  units  of  availability  is  assumed  to  be  variable. 


The  end  of  simulation  time  is  the  time  in  calendar  units  when  the  sim- 
ulation is  terminated. 

The  bucket  size  for  performing  air  base  calculations  is  used  to  par- 
tition time  into  intervals. 

Calendar  units  per  year  are  the  number  of  calendar  units  in  a year.  This 
number  defines  the  size  of  a "calendar  unit",  used  in  all  calculations  as  the  basic 
unit  of  time  measurement. 

The  amount  of  output  can  be  controlled  by  use  of  a logical  switch.  The 
default  is  that  all  reports  will  be  printed.  By  setting  the  logical  switch  to  T, 
the  user  can  suppress  several  reports.  This  control  feature  will  be  discussed  in 
more  detail  in  the  output  section. 


OUTPUT 


Phase  2 writes  five  binary  files  and  three  reports.  The  binary  files 
contain  the  following  information: 


• UNIT  20  contains  names,  blocks  and  bucket  sizes  to  be  used 

in  Phase  3 

• UNIT  21  contains  graduation  requirements  used  in  Phase  3 


• UNIT  22  contains  sources  used  in  Phaso  3. 

• UNIT,  23  contains  resources  used  in  ^'Phases  3 and  4. 

• UNJT  24  contains  resource  information  used  in  Phase  4. 


The  following  reports  are  produced  on  unit  6. 

• AIR  BASE  REPORT 

• COPILOT  RECOVERY  REPORT 

• COURSE  REPORT 

The  airbase  report  has  a standard  output,  that  may  be  preceded  by  an 
optional  higher-level-of-detail  output.  The  standard  report  contains  for  each 
air  base  individually,  and  for  the  aggregate  of  air  bases,  the  following: 

• total  number  of  people  attrited 

• total  number  of  attritees  replaced 

• total  number  of  new  people  required 

The  optional  report  adds  for  each  air  base  and  air  base  bucket: 

• number  of  aircraft 


minimum  crew  (number  of  aircraft  times  crew  ratio) 

for  each  type  of  crew  member  (pilot,  copilot,  OSOS,  DSOS) : 


u 

0 

[] 

0 

0 

uJ 


• number  of  crewmembers  attrited 

• number  of  attritees  replaced 

• number  of  new  people  needed 

• total  number  at  the  base 

See  examples  2.4.1A  and  2. 4. IB. 

The  copilot  recovery  report  contains  the  number  of  copilots  recovered 
as  a function  of  years  (optional),  and  the  total  number  of  copilots  recovered 
(standard).  See  example  2.4.2. 
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EXAMPLE  2.4.1A 
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The  course  report  contains  the  number  of  people  required  from  each 
course  as  a function  of  years  (optional).  The  total  number  of  people  required 
from  each  course  and  from  all  courses  is  printed  (standard).  See  examples 
2.4. 3A  and  2.4.3B. 

In  addition  to  these  reports,  the  control  parameters  are  printed. 

See  example  2.4.4. 
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Z .~T~ 


COURSE  DEMANDS  (OPTIONAL) 


TIME  (YEARS) 


COURSE 

1 

2 

3 

4 

1 

PILOTS 

a. 

83. 

118. 

65. 

5 

COPILOTS 

0. 

83. 

118. 

65. 

14, 

OSOS 

0. 

83. 

118. 

85. 

78 

DSOS 

0. 

83. 

118. 

85. 

78, 

CCTSP 

0. 

C. 

88. 

2 08. 

269 

CCTSC 

0 • 

c • 

88  . 

2C8  • 

2 69 

CCTSO 

0. 

0. 

88. 

2C8. 

269 

CCTSD 

0. 

c. 

88. 

208. 

269 

PMTP2 

0. 

40. 

203. 

363. 

367 

PMTC2 

0. 

40. 

203. 

363. 

367 

PMT02 

0. 

40. 

203. 

363. 

367 

PMTD2 

0. 

40. 

203. 

363. 

367 

PMTP3 

0. 

79. 

240. 

245. 

295 

PMTC3 

0. 

79. 

240. 

245. 

245 

PMT03 

0. 

79. 

240. 

245. 

245 

PMTD3 

0. 

79. 

240. 

245. 

245 

PMTP5 

0. 

0. 

83. 

328. 

485 

PMTC5 

c. 

0. 

83. 

328. 

465 

PMT05 

0. 

0. 

83. 

328. 

485 

PMTD5 

0. 

0. 

83. 

328. 

465 

EXAMPLE  2.4.3A 
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COURSE 

TOTAL 

PILOTS 

270.0 

COPILOTS 

278.5 

USOS 

363.1 

DSOS 

363.1 

CCTSP 

564.9 

CCTSC 

564.9 

CCTSO 

564.9 

CCTSO 

564.9 

PMTP2 

972.7 

PMTC2 

972.7 

PMT02 

972.7 

PMTD2 

972.7 

PMTP3 

808.5 

PMTC3 

808.5 

PMT03 

808.5 

PMTD3 

808.5 

PMTP5 

896.9 

PMTC5 

896.9 

PM.T05 

896.9 

PMTD5 

896.9 

bRAND  TOTAL 

14246.5 

1 


COURSE  DEMANDS 


2.5 


F.RRQR  MESSAGES  GENERATED  IN  PHASE  2 


lj 


D 

y 


j 


1.  TOO  MANY  NAMES  - CHANGE  VARIABLE  MAXNUM  AND  ARRAY  NAMES  IN  COMMON  NAM 
Recompile  - array  is  too  small  to  store  names. 

2.  ARRAY  IWORD  TOO  SMALL  TO  STORE  ALL  BLOCKS 

Recompile  - array  too  small  to  handle  all  PROC,  TASK,  RUB  and  RUDB  blocks. 


3.  TOO  MANY  BLOCKS  LINKED  TO  PROC  BLOCK 

Input  error  - PROC  blocks  can  have  only  five  preceding  or  succeeding 
PROC  blocks. 


: i 

F! 


L 


4.  NUMBER  OF  COURSES  AND  NUMBER  OF  GRADUATION  BLOCKS  DO  NOT  AGREE 

Input  error  - There  must  be  one  and  only  one  graduation  block  for 
each  course. 


5.  SYN  LOOP  STARTING  AT  i EXCEEDS  n BLOCKS 

Input  error  - Synchronization  and  correlation,  loops  are  limited  to  a 

maximum  length.  Program  must  be  recompiled  to  change  this 
limit . 


6.  SYN  LOOP  STARTING  AT  i IS  NOT  CLOSED 

Input  error  - Synchronization  and  correlation  loops  must  be  closed. 

The  last  PROC  block  must  point  to  the  first  PROC  block  in 
the  loop. 

7.  SYN  LOOP  STARTING  AT  i HAS  LENGTH  1 

Input  error  - Synchronization  and  correlation  loops  must  contain  more 
than  one  PROC  block 


8.  TRACK  TOO  LONG  IN  COURSE  i PROC  BLOCKS  ARE  Pr--Pn 

Input  error  - PROC  blocks  in  a track  exceed  a maximum  number  or  the 

track  does  not  terminate  due  to  a bad  transfer  card.  Re- 
compile to  increase  maximum  track  length. 


LJ 
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ERROR  MESSAGES  ( CONT.  ) 


DEPTH  OF  RUDB  and  RUB  STARTING  AT  RUDB  i EXCEEDS  n BLOCKS  - THESE 
BLOCKS  ARE  bj..  .bn 

Input  error  - bloc*  S" 

compile  to  increase  maximum  number  of  blocks. 

THE  NUMBER  OF  BUCKETS  IS  OUT  OF  RANGE  MXBUCK=i 

- ~ ' Sr 

can  be  handled. 


THE  NUMBER  OF  AIR  BASES  IS  OUT  OF  RANGE  NAB=n 

Recompile  - The  number  of  air  bases  exceeds  the  storage  allocated  to 
air  bases. 

THE  NUMBER  OF  AIR  BASE  EVENTS  IS  OUT  OF  RANGE  NABE-n 

Recompile  - The  number  of  air  base  events  exceeds  the  storage  allocated 
to  air  base  events. 


THE  NUMBER  OF  CCT'S  IS  OUT  OF  RANGE  NABC=n 

Recompile  - The  number  of  CCTS  courses  exceeds  the  storage  allocated  to 
CCTS  courses. 


THE  NUMBER  OF  PMTS  IS  OUT  OF  RANGE  NABP=n 

Recompile  - The  number  of  PMT  groups  exceeds  the  storage  allocated  to 
PMT  courses . 

THE  NUMBER  OF  AIR  BASE  DELIVERIES  IS  OUT  OF  RANGE  NABD=n 

Recompile  - The  number  of  air  base  deliveries  exceeds  the  storage  alio- 
cated  to  air  base  deliveries. 

TOO  MANY  COURSES  DEFINED 

Recompile  - The  total  number  of  courses  exceeds  the  space  allocated  to 
these  courses. 


ERROR  MESSAGES  ( CONT.  ) 


CCTS  COURSE  FOR  PILOTS  NOT  DEFINED  TIME=t 

Input  error  - There  is  a demand  for  a PILOT  where  no  CCTS  course  was 
defined. 

CCTS  COURSE  FOR  COPILOTS  NOT  DEFINED  TIME=t 

Input  error  - There  is  a demand  for  a COPILOT  where  no  CCTS  course  was 
defined . 

CCTS  COURSE  FOR  OSOS  NOT  DEFINED  TIME=t 

Input  error  - There  is  a demand  for  a OSO  where  no  CCTS  course  was 
defined. 

CCTS  COURSE  FOR  DSOS  NOT  DEFINED  TIME=t 

Input  error  - There  is  a demand  for  a DSO  where  no  CCTS  course  was 
defined. 

NO  COURSE  DEFINED  FOR  PMT  INTERVAL  AB=i  TIME=t  PMT=j 

Input  error  - No  course  was  defined  for  PMT. 

PMT  NOT  FEASIBLE  FOR  AB=i 

Input  error  - PMT  not  feasible  for  this  air  base. 

NO  AIR  BASE  EVENT  CARD  FOR  AB=i 

Input  error  - Air  base  event  card  missing  for  this  air  base. 
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24.  THE  NUMBER  OF  PARAMETERS  SPECIFIED  FOR  RESOURCE  i DOES  NOT  AGREE  WITH  THE 


GENERATING  FUNCTION  REQMTS 

Input  error  - The  uniform  generating  function  requires  two  parameters. 

THE  BUCKET  SIZE  (SECOND  PARAMETER)  - MUST  BE  GREATER  THAN  ZERO 

Input  error  - The  bucket  size  for  resources  and  sources  using  the  uni- 
form generating  function  must  be  greater  than  zero. 


71 


ERROR  MESSAGES  ( CONT.) 


y 


26. 


TOO  MANY  RESOURCES  - INCREASE  ARRAY  SIZES 

Recompile  - The  number  of  resources  exceeds  space  allocated  to  resources. 


u 
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27.  TOO  MANY  RESOURCE  CARDS  - INCREASE  ARRAY  SIZES 

Recompile  - The  number  of  resource  cards  exceeds  space  allocated  to 
resource  cards. 

28.  THE  NUMBER  OF  PARAMETERS  SPECIFIED  FOR  SOURCE  i DOES  NOT  AGREE  WI^H  THE 
GENERATING  FUNCTION  REQMTS 

Input  error  - The  uniform  generating  function  requires  two  parameters. 

29.  SOURCE  CARD  MISSING  FOR  COPILOTS 

Input  Error  - A source  card  for  COPILOTS  is  required. 

30.  TOO  MANY  SOURCES  - INCREASE  ARRAY  SIZES 

Recompile  - The  number  of  sources  exceeds  space  allocated  to  sources. 

31.  TOO  MANY  SOURCE  CARDS  - INCREASE  ARRAY  SIZES 

Recompile  - The  number  of  source  cards  exceed-  space  allocated  to 
source  cards. 
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32. 


33. 


34. 


THE  NUMBER  OF  PMT  COURSES  IS  OUT  OF  RANGE  NABPC=n 

Recompile  - The  number  of  PMT  courses  exceeds  the  storage  allocated 
to  PMT  courses. 

SYN  LOOP  STARTING  AT  n DOES  NOT  HAVE  A SYNCH  OR  CORRELATE  TASK 

Synchronization  task  must  be  specified  for  all  blocks  in  synchronization 
loop. 


SYN  LOOP  STARTING  AT  n CONTAINS  BLOCK  m THAT  DOES  NOT  HAVE  A SYNCH 
OR  CORRELATE  TASK  IN  C0M40N  WITH  ORIGINAL  BLOCK 


All  blocks  in  synchronization  loop  must  have  the  same  synchronization 
task. 
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3.1  INTRODUCTION 

3.1.1  Contents  of  This  Section 


The  inputs  to  Phase  3 are  very  limited  (see  Section  3.3.1)  as  is 
the  normal  output  report  (normally  consisting  of  an  echo  of  the  inputs  and  a 
successful  conclusion  message). 

The  remainder  of  Section  3.1  gives  an  overview  of  Phase  3 of  TRAM, 

It  is  followed  by  Section  3.2  describing  the  major  features  of  the  program  in 
greater  detail.  Sections  3.3  and  3.4  describe  the  inputs  and  outputs. 

3.1.2  Purpose 

The  purpose  of  the  Phase  3 TRAM  Program,  is  to  simulate  the  progress 
of  related  groups  of  trainees  through  sets  of  instructional  blocks  that  define 
specific  training  programs.  Key  items  of  the  simulation  are: 

1.  Calculation  of  the  resources  used  by  the  classes  during 
training. 

2.  Time  synchronization  of  instruction  for  members  of  individual 
crews . 

3.  Time  correlation  of  instructional  blocks  that  require  more 
than  one  type  of  crewmember. 

4.  Provision  for  alternate  training  paths  for  trainees  with 
different  prior  experience. 

5.  Automatic  selection  of  trainee  types  based  on  assigned  pri- 
orities and  availability  at  matriculation  time. 

6.  Graduation  scheduling,  and 

7.  Introduction  of  time  lags  into  the  instruction  sequence  when 
needed  resources  are  not  available  or  when  necessary  to 
achieve  synchronization  or  correlation. 

The  inputs  to  Phase  3 consist  of: 

1.  Time  ordered  training  demands. 
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2.  Resource  and  trainee  inventories  for  the  simulated  time 
interval. 

3.  Description  of  the  training  program,  and 

4.  Execution  control  parameters. 

The  outputs  consist  of: 

1.  Resource  and  trainee  inventories  remaining  after  training 
demands  have  been  satisfied. 

2.  Records  describing  lags,  and 

3.  Records  showing  the  entry  of  trainees  into  the  system. 

Processing  is  done  on  an  individual  class  and  instructional  block 
basis.  That  is,  the  progress  of  each  individual  group  of  trainees  through 
each  of  the  instructional  blocks  comprising  the  required  training  course  is 
simulated  in  detail. 


3.1.3  Treatment  Of  Time 

The  courses  consist  of  blocks  of  instruction  which  are  linked  in  the 
order  in  which  they  are  taken  by  the  trainees.  By  convention,  the  trainee  pro- 
ceeds from  right  to  left.  The  blocks  on  the  left  are  temporarily  before  blocks 
on  the  right. 

The  program  processes  in  reverse  time  order.  This  leads  to  a certain 
awkwardness  in  expressions  involving  time  such  as  the  "latest",  "previous",  etc., 
which  all  have  their  correct  "real  time"  meaning  rather  than  in  the  sense  of  the 
order  in  which  the  processing  is  performed. 
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PROGRAM  DESCRIPTION 


3.2.1  Overall  Description 


I 


The  basic  functions  performed  by  the  Phase  3 TRAM  Program  are: 

1.  Form  classes  from  the  training  demands  and  associate  them 
with  the  rightmost  instructional  block  of  the  pertinent 
course. 

2.  Maintain  a simulation  clock.  Processing  is  done  in  reverse 
time  order.  The  simulation  starts  at  the  end  of  the  simu- 
lation period  and  progresses  to  the  simulation  start  time. 

Thus,  the  first  instructional  block  processed  for  a class 
is  the  graduation  block  and  the  last  instructional  block 
processed  is  the  matriculation  block. 

The  simulation  is  event  oriented.  Processing  only  occurs 
at  those  clock  times  when  one  or  more  classes  are  scheduled 
to  go  through  a processing  block  or  procbloc,  the  model  ana- 
log of  the  instructional  block. 

3.  Select  all  the  classes  that  are  scheduled  for  execution  at  the 
current  simulation  clock  time.  The  classes  are  sorted  in  or- 
der by  priority,  high  priority  first. 

4.  Loop  through  active  classes. 

a)  For  each  active  class  selected,  construct  a list  of  the 
tasks  that  must  be  executed. 

b)  Invoke  the  appropriate  modules  required  to  perform  the 
individual  tasks.  The  correlation  and  synchronization 
tasks  require  the  merging  of  the  tasks  of  several  classes 
for  execution  in  parallel.  When  this  happens,  the  classes 
that  were  included  in  the  correlation  or  synchroniation 
loop  are  marked  inactive  for  the  remainder  of  this  time 
period. 

c)  Test  to  see  if  the  task  was  executed  successfully.  If  so 
then  the  next  task  is  executed,  and  when  all  tasks  are 
done  the  next  class  is  processed.  If  the  task  failed  then 
the  program  either  stops,  prints  a message  and  continues, 
or  lags  the  class  depending  on  the  processing  option  selec- 
ted on  the  control  cards . 

5.  Release  the  storage  occupied  by  classes  that  have  finished  ex- 
ecuting a procbloc  that  has  no  left  branches. 
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Create  Classes  From  Queued  Demands 
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Are  There  Any  Active  Classes'! 


Select  Classes  Scheduled  For  Execution  At  This  Time 


Processing  is  performed  by  subroutine  PREPC.  Section  32? 
discusses  the  details.  section  s.z.2 
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Figure3  .1.1  GENERAL  FLOW  CHART  OF  PHASE  3 TRAM  PROGRAM 
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Update  Simulation  Clock 

This  function  is  performed  periodically,  approximately  every 
50  calendar  units.  Whenever  the  simulation  clock  is  updated 
the  data  management  routines  store  resource  and  source  inven- 
tories for  times  greater  than  the  clock  time  on  disk  and  fill 
the  buffers  with  earlier  inventories. 


On  Classes 


In  subroutine  PREPC  pointers  to  all  classes  scheduled  for  exe- 
cution at  this  time  were  placed  in  a sequential  list.  This 
list,  sorted  in  decreasing  order  by  priority,  is  the  basis  for 
this  loop. 


Is  Class  Active? 

Initially  all  classes  are  marked  as  being  active.  When  classes 
that  are  part  of  a synchronization  or  correlation  loop  are  con- 
catenated for  processing  by  a class  performing  a synchronization 
or  correlation  task,  they  are  marked  as  being  inactive  for  the 
rest  of  this  iteration. 


Make  List  Of  Tasks 


This  function  is  performed  by  subroutine  LSTASK.  This  list  is 
generated  from  the  list  of  tasks  specified  in  the  active  proc- 
bloc.  The  tasks  are  arranged  in  order  by  precedence  (synchro- 
nization and  correlation  first,  resource  utilization  second, 
followed  by  source  allocation  (SCATSA  or  GET30URCE)).  In  addi- 
tion inventory  update  and  class  transfer  tasks  are  automatically 
inserted  by  the  program  into  the  list. 


On  Tasks 


This  loop  normally  ranges  on  the  list  described  in  Item  10. 
However,  when  a synchronization  or  correlation  task  is  performed 
successfully,  the  list  is  over-written  by  subroutine  SYNCT  which 
generates  a concatenated  list  of  the  tasks  that  must  be  performed 
by  all  the  classes  in  the  synchronization  or  correlation  loop. 


Invoke  Appropriate  Module  To  Execute  Task 


These  modules  are: 
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A.  SYNC  (Synchronization,  described  in  detail  in  Section 
3.2.3) 

B.  CORR  (Correlation,  described  in  detail  in  Section3. 2.4) 

C.  RESUSE  (Resource  utilization,  described  in  detail  in 
Section  3.2.5) 

D.  SCATSA  (Source  allocation,  described  in  detail  in  Sec- 
tion 3.2.6) 

E.  UPDATE  (Update  of  resource  inventories,  See  Section  3.2.5) 


F.  GET-SOURCE  (See  Section  3.2.6) 

G.  DTRNSF  (Transfer  of  classes,  described  in  Section  3.2.7) 


13.  Was  Task  Execution  Successful? 


The  only  tasks  that  can  fail  are  resource  utilization,  source 
allocation,  synchronization  and  correlation.  If  source  allo- 
cation fails  the  program  prints  an  appropriate  error  message 
and  stops.  It  is  assumed  that  the  lowest  priority  track  for 
each  course  will  be  an  essentially  infinite  source  of  trainees. 

If  a resource  utilization  task  fails  then  one  of  three  options 
is  available: 

A.  Stop  after  printing  an  error  message. 

B.  Continue  after  printing  an  error  message. 

C.  Reschedule  (LAG)  the  class  for  execution  at  an  earlier  time. 

If  a synchronization  or  correlation  task  fails,  the  classes  af- 
fected are  rescheduled  for  execution  at  an  earlier  time.  Figure 
3.1.2  shows  the  input  and  output  data  sets  used  by  the  Phase 
3 TRAM  program. 


3.2.2 


Class  Formation 


Training  demands  are  calculated  in  Phase  2 of  the  TRAM  Program  from  the 
schedule  of  aircraft  deliveries,  forecast  attrition  rates  and  requirements  for 
proficiency  maintenance  training.  These  demands  are  passed  to  Phase  3 in  the 
form  of  6-word  records  sorted  in  descending  order  by  time.  Figure  3.1.2  describes 
the  format  of  the  training  demand  records . 
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The  processing  of  training  demand  records  forms  an  integral  part  of 
the  overall  logic  of  Phase  3.  After  the  program  initialization  is  finished  sub- 
routine FORMQ  is  invoked.  In  this  routine  a training  demand  record  is  read. 

The  time  of  the  demand  is  used  to  calculate  the  set  of  graduation  dates  for  all 
courses  in  the  system,  by  means  of  the  following  relations: 

1.  Graduation  number  = (Demand  Date-Date  of  first  graduation) 

/ intercourse  period 

2.  Current  Graduation  Date  = Date  of  first  graduation  + 

(Graduation  number  * intercourse 
period) 

3.  Previous  Graduation  Date  = Current  graduation  date  - intercourse 

period 

The  times  of  the  earliest  current  graduation  and  the  latest  previous 
graduation  are  saved.  The  information  in  the  training  demand  records  is  saved 
in  a linked  list  addressable  by  individual  courses.  Additional  records  are 
read  and  stored  until  the  demand  time  is  less  than  the  earliest  current  gradua- 
tion . 

Subroutine  FORMC  is  invoked  next.  FORMC  loops  through  the  courses  and 
places  all  demands  with  a time  greater  than  or  equal  to  the  current  graduation 
date  for  a course  in  temporary  storage.  These  demands  are  added  up  for  each 
course.  After  the  current  graduation  requirements  are  known  for  each  course, 
subroutine  CLASCG  is  used  to  create  classes. 

In  CLASCG  the  course  grouping  by  crews  specified  on  the  input  cards  is 
used  to  determine  the  maximum  number  of  complete  crews  that  can  be  formed  at  this 
time.  These  classes  are  formed  using  routines  MLTCLS  and  NEWCLS  and  are  assigned 
a crew  identification  number.  The  trainees  that  could  not  be  assigned  to  a crew 
are  made  into  "extras"  classes,  and  given  a crew  identification  number  of  -1. 
Classes  are  represented  as  30-word  blocks  stored  in  a linked  list. 

Subroutines  FORMQ  and  FORMC  are  only  invoked  when  the  simulation  clock 
time  is  less  than  the  latest  previous  graduation  time.  For  each  cycle  of  the 
simulation  clock  subroutine  PREPC  is  invoked  to  select  the  classes  that  are 
scheduled  for  processing  at  that  time.  The  classes  selected  are  sorted  in  de- 
creasing order  by  class  priority.  Since  the  class  priority  is  increased  each 
time  a class  is  lagged  due  to  a resource  allocation  failure,  the  sort  will  put 
it  in  a better  position  to  avoid  further  lags. 


3.2.3  Synchronization 


Synchronization,  as  the  word  is  used  in  the  TRAM  Program,  means  that 
all  the  crew  members  included  in  the  synchronization  loop  must  perform  their 
assigned  tasks  simultaneously.  An  example  of  this  would  be  that  a pilot  trainee 
and  a copilot  trainee  must  occupy  their  respective  positions  in  a two  place  flight 
simulator. 
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The  definition  of  the  synchronization  loops  is  imbedded  in  the  course 
description.  Each  procbloc  can  point  to  another  procbloc  with  which  it  is  syn- 
chronized. These  pointers  can  refer  to  procblocs  in  another  track  of  the  same 
course  or  to  procblocs  in  another  course.  These  pointers  must  form  a closed 
loop.  That  is,  the  last  procbloc  in  the  synchronization  loop  points  to  the  first 
procbloc  in  the  loop.  These  links  are  used  to  force  either  correlation  or  synchro- 
nization of  the  procblocs.  Correlation  is  described  in  the  next  subsection. 

In  order  to  force  synchronization,  a synchronization  task  must  be  spe- 
cified for  each  procbloc  within  the  synchronization  loop.  Before  the  tasks  that 
a class  must  execute  in  a procbloc  are  processed,  the  tasks  are  rearranged  in 
subroutine  LSTASK.  In  this  rearrangement  the  synchronization  (or  correlation) 
task  is  placed  at  the  start  of  the  list.  Only  one  such  task  is  allowed  per  proc- 
bloc. When  the  synchronization  task  is  executed,  the  program  follows  the  syn- 
chronization loop  and  picks  up  all  the  classes  with  the  proper  crew  number  currently 
awaiting  execution  at  the  individual  procblocs.  The  students  in  the  classes 
awaiting  execution  are  summed  by  the  course  they  are  in.  Finally  a check  is  made 
to  see  if  the  same  number  of  students  is  in  each  of  the  courses  linked  by  the 
synchronization  loop.  If  the  number  of  trainees  in  each  of  the  courses  is  equal 
then  synchronization  is  possible,  and  subroutine  SYNCT  is  invoked  to  make  up  a 
new  list  of  tasks.  If  the  numbers  of  trainees  in  the  individual  courses  are  not 
the  same,  then  synchronization  is  impossible  at  this  time  and  the  classes  that  are 
currently  scheduled  for  execution  in  the  synchronized  procblocs  must  be  lagged 
until  the  missing  trainees  catch  up. 

Subroutine  SYNCT  extracts  the  tasks  from  the  procblocs  associated  with 
each  of  the  synchronized  classes  and  arranges  them  in  such  a way  that  all  resource 
consumption  tasks  will  be  executed  fir;>t.  If  these  tasks  can  be  executed  success- 
fully, then  the  resource  inventories  can  be  updated  and  the  remaining  tasks 
for  the  individual  classes  can  be  done.  If  any  of  the  tasks  fail  because  of  un- 
availability of  resources,  then  all  the  tasks  are  considered  to  have  failed,  no 
resource  utilization  update  is  done  and  the  classes  are  lagged  to  a time  when  the 
scarce  resource  is  again  available. 


3.2.4  Correlation 

Correlation  works  very  similarly  to  synchronization.  The  same  method 
is  used  for  linking  procblocs  in  a closed  loop  and  a correlation  task  must  be 
specified  for  each  of  the  procblocs  in  the  loop. 

The  basic  difference  lies  in  the  fact  that  the  correlated  classes  do 
not  need  to  have  the  same  crew  identification  number  and  the  equal  number  of 
trainees  in  each  course  requirement  is  relaxed  to  requiring  that  at  least  one 
student  be  present  in  each  of  the  courses  of  the  correlation  loop. 

Only  classes  that  make  up  a crew  can  request  correlation,  but  extras 
classes  can  be  used  to  satisfy  the  requirement  that  trainees  be  present  from 
each  course. 
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time  that  then  the  total  amount  of 

MAXLAG.  If  the  total  lag  tine  eouala ft L,  feCted  against  the  ™P“'  variable 
marked  as  an  extras  class  and  processed  as  suchS  ^XLAG  value,  the  class  is 

exceed  the  MAXLAG  value,  the  classes  are  lagged*  the  tCtal  lag  time  does  not 

3*2.5  Resource  Use 

is  specified  by  means  of Zthe°resource1utilizat^  the  taSkS  °f  a Procbloc 

utilization  description  bleaks  (RUDB) . 1011  oc^s  (RUB)  and  the  resource 


from  1 to 

Resource  inventories  are  not  descrih^  Qe  u • , 

as  quantities  of  units  of  consumption  avail  Pbysical . entities  but  rather 

time.  Thus  the  inventory  for  a simularnr  ma  ’ °?r  tbe  utllity  yield  per  unit 

use  per  week.  All  inventories  are  ^ I«ege(  ES?  ‘hat  11  xields  96  hours  of 

secondary  resource  is  one^hich1" t'used  onl^iTthe  P?imarf.and  Secondary.  A 
of  secondary  resources  is  permitted.  Each  RUHR  nf  P™31^  ls  used.  One  level 
to  an  RUB  of  secondary  resources . 3 Primary  resource  can  point 

A RUDB  can^poin^t^an^lternate  006  ^-rnates. 

ternate  and  so  on.  n h ’ in  turn>  point  to  another  al- 

chronized  or  collated  procbl^s(0is°compiledrethlaSS“  <aS  in  the  Case  o£  syn- 
procblocs  involved  is  saved  Thi-  tin,.  ”Paled-  the  maximum  time  extent  of  the 
the  inventory  o,  any  Source  tha  HmitS  f°r 

the  pertinent  resources'ar^brought  into^ocaPt  CO"su,"ptio"'  the  inventories  of 
already  there)  and  all  updates  are  done  in  thesPPc^LrayP8*  Wf  they  n0t 

cessful . IZTtTlit  f 1™°“™  all°aati°"  ia  — 

daries  have  been  satisfied.  After  all  arrays’  until  the  secon- 

cuted  successfully,  subroutine  UPDATE  i,  J ce  Vt;LJ^zatlon  tasks  have  been  exe- 
manent  update  of  the  inventories  of  th.^  JT ^ally  inV°ked  to  Perfo™  a Per- 
tities  actually  consumed  ^ affeCted  resources  *>  reflect  the  quan- 
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The  two  program  modules  responsible  for  allocating  trainees  to  the  pro- 
per courses  are  TRACKD  and  SCATSA. 

Instructional  courses  in  TRAM  have  generally  a tree  structure.  The 
graduation  block  (or  rightmost  procbloc  of  a course)  constitutes  the  start  of  the 
trunk  of  the  tree.  The  data  path  is  from  right  to  left  (in  reverse  time  sequence) 
with  each  procbloc  capable  of  being  split  into  five  branches.  This  branching  pro- 
cess can  be  repeated  for  each  branch  any  number  of  times.  Procblocs  that  have 
more  than  one  left  branch  are  called  nodes.  Each  possible  path  from  the  gradua- 
tion block  to  a source  block  (procbloc  without  any  left  branches)  is  called  a 
TRACK.  An  individual  track  can  have  one  or  more  nodes.  This  tree  structure  is 
represented  within  TRAM  by  means  of  TRACK  DESCRIPTOR  BLOCKS  (TDBs) . There  is  one 
TDB  for  each  node  along  every  track. 
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The  purpose  of  the  TRACKD  Module  is  to  create  the  TDBs  required  to  de- 
scribe the  particular  courses  being  processed.  TRACKD  is  invoked  from  subroutine 
INIT  during  the  program  initialization  phase.  The  processing  performed  by  TRACKD 
can  be  separated  into  3 distinct  phases : 

1.  A right  to  left  scan  is  done  for  each  course  in  order  to  locate 
all  procblacs  that  have  no  left  branches.  These  procblocs  are 
checked  for  the  presence  of  a "GETSOURCE"  task  and  pertinent  in- 
formation (procbloc,  task,  RUB  and  RUDB,  addresses,  source  num- 
ber, etc.)  is  saved  in  an  array  indirectly  indexed  by  course  num- 
ber. 

2.  A left  to  right  scan  is  performed  starting  at  each  source  block 
isolated  in  Step  1.  During  the  scan  time-to-source  is  updated  by 
the  duration  of  individual  procblocs. 

The  scan  is  interrupted  whenever  a procbloc  with  more  than  one 
left  branch  is  encountered.  At  these  nodes  the  priorities  and 
proportions  are  accumulated  and  track  descriptor  blocks  are  created. 
The  recursive  formulas  for  accumulating  priorities  and  proportions 
are : 


Cumulative  Proportion  = Current  Proportion  x 

Previous  Proportion 

Cumulative  Priority  = Current  Priority  x 

(Previous  Priority/ 100) 

If  more  than  one  node  is  encountered  along  the  track,  the  later 
TDB  has  a pointer  to  the  previous  TDB. 
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The  final  result  is  that  there  is  a track  descriptor  block  for  each 
procbloc  with  multiple  left  branches  within  each  track. 

The  actual  allocation  of  students  to  individual  sources  is  performed 
by  the  SCATSA  module . The  SCATSA  task  can  only  be  defined  in  procblocs  with 
multiple  branches.  The  normal  procedure  is  to  use  one  SCATSA  task  within  a course 
and  to  place  it  at  the  rightmost  node. 

When  a class  is  called  upon  to  execute  a SCATSA  task  the  following 
processing  takes  place: 

1.  Tracks  are  selected  in  order  by  priority  by  subroutine  LSTRAK. 

The  first  time  through,  the  track  or  tracks  with  the  highest 
priority  are  selected. 

2.  Subroutine  ALLOCD  calculates  the  number  of  students  that  should 
be  allocated  to  each  track  based  on  the  proportions  computed  by 
TRACKD  for  this  particular  node.  Subroutine  ALLOC  reads  in  the 
appropriate  inventories  and  allocates  to  each  track  the  minimum 
of  quantity  available  and  quantity  desired. 


3.  If  all  students  have  been  allocated  by  ALLOCD,  Step  7 is  executed 
next. 

4.  If  some  students  have  not  been  allocated  then  subroutine  ALLOCA 
attempts  to  allocate  them  to  any  of  the  currently  active  tracks 
that  have  a positive  inventory. 

5.  If  all  students  have  been  allocated  by  ALLOCA,  Step  7 is  executed 
next . 

6.  If  some  students  remain  unallocated,  then  the  track  or  tracks  with 
the  next  highest  priority  are  selected  and  processing  returns  to 
Step  2. 

7.  After  all  students  have  been  allocated,  subroutine  FRMPTB  is  invoked 
to  form  the  predetermined  transfer  blocks  for  this  class.  Section 
3.2.7  describes  how  the  PTBs  are  used  to  transfer  classes  along 

the  selected  paths. 

3.2.7  Transfers 

The  transfer  of  classes  from  a successfully  completed  procbloc  to  the 
next  is  done  automatically  by  the  program.  The  processing  involved  in  effecting 
a transfer  depends  on  the  number  of  left  branches  in  the  active  procbloc  and,  in 
the  case  of  multiple  branches,  whether  or  not  the  JCATSA  Task  has  been  done  by 
the  class.  The  four  possibilities  are: 
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1.  No  Left  Branches  This  means  that  the  class  has  completed  the 

leftmost  procbloc  of  the  track.  The  storage  space  occupied  by 
the  class  is  released  and  no  further  processing  of  the  class 
takes  place.  (Note:  In  order  to  generate  a record  of  "matricu- 

lation" a "GETSOURCE"  task  must  be  specified  for  the  leftmost 
procbloc  of  the  track.) 

2.  One  Left  Branch  The  class  block  is  updated  to  reflect: 

a)  The  next  scheduled  execution  time  for  the  class,  and 

b)  The  address  of  the  next  procbloc  to  be  executed. 

3.  More  Than  One  Left  Branch,  SCATSA  Not  Executed  The  cumulative 
priorities  and  percentages  for  the  individual  branches  are  used 
to  calculate  how  many  students  should  be  sent  to  each  branch. 

This  is  done  without  any  regard  to  the  availability  of  trainees 
at  the  required  matriculation  time.  New  class  blocks  are  created 
for  each  group  of  students.  Crew  identification  numbers  are 
maintained.  The  original  class  block  is  removed  from  the  active 
list. 

4.  More  Than  One  Left  Branch,  SCATSA  Executed  This  case  is  re- 
cognized  by  the  program  by  the  non-zero  value  in  the  variable 
"IPREDT"  in  the  class  block.  IPREDT  contains  the  address  of  the 
predetermined  transfer  block  created  by  SCATSA  for  this  class- 
procbloc  combination.  The  values  in  the  predetermined  transfer 
block  are  used  to  create  new  classes  for  each  of  the  active 
tracks.  The  old  class  and  PTB  are  removed  from  active  storage. 

CASES  1 and  2 are  handled  by  subroutine  DTRNSF . 

CASES  3 and  4 are  handled  by  subroutine  SPLIT 
(Invoked  automatically  by  DTRNSF.) 


3,2.8  Data  Management 

Because  of  the  dynamic  data  flow  in  the  Phase  3 TRAM  Program,  the  stan- 
dard FORTRAN  array  and  indexing  structures  are  inadequate  in  terms  of  core  uti- 
lization and  computational  efficiency. 

Most  of  the  information  used  by  the  program  is  grouped  into  blocks  of 
data  that  are  organized  using  singly  linked  lists.  This  method  makes  it  possible 
to  add  and  delete  blocks  to  the  lists  without  a need  for  periodic  reorganization. 


The  procblocs,  task  blocks,  resource  utilization  blocks  (RUBs)  and  | 

resource  utilization  description  blocks  (RUDBs)  share  a common  pool  of  storage 
in  common  BLKS  and  are  accessed  directly  by  their  addresses.  Subroutine  BLOCK 
is  used  to  copy  any  of  these  blocks  into  local  storage. 
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description  of  inputs 

The  inputs  to  Phase  3 of  TRAM  consist  of: 

1 Execution  control  parameters  (on  cards). 

2.  Time  ordered  training  demands. 

3.  Resource  inventories  for  the  simulated  time  interval. 

4.  Trainee  inventories  for  the  simulated  time  interval. 

5.  A description  of  the  training  program. 

Each  of  these  inputs  is  discussed  in  the  following  subsections 


3.3.1  Execution  Control  Parameters 

These  inputs,  contained  on  7 or  more  cards,  allow  the  user  to  control 
, 1-imp  extent  of  the  simulation,  the  amount  of  diagnostics  generated,  the 
^ogram  action  in  case  of  synchronization,  correlation  or  resource  allocation 
failure  and  the  grouping  of  courses  for  purposes  of  crew  formation.  . 

The  detailed  formats  of  the  input  cards  are  as  follows: 


CARD  # 

CARD  COL. 

VARIABLE 

FORMAT 

i 

1-8 

ITIMES 

18 

9-16 

itimee 

18 

2 

1-50 

IFLOW(50) 

5011 

DESCRIPTION 


Start  time  of  simulation 
End  time  of  simulation 

Control  switches  for  program 
flow  messages  at  the  beginning 
of  important  subroutines 
If  IFL0W(I)=1  flow  message  is 
printed 

If  IFLOW(I)=0  flow  message  is 
not  printed 
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1 

CARD  # 

CARD  COL. 

VARIABLE 

FORMAT 

DESCRIPTION 

iJ 

3 

1-50 

I DUMP (50) 

5011 

Control  switches  for  diagnostic 
messages  in  important  routines. 

If  IDUMP(I)=1  diagnostic  messages 
are  printed. 

If  I DUMP (I) =0  diagnostic  messages 
are  not  printed. 

U 

4 

1-8 

ITRNRU 

18 

FORTRAN  unit  for  training  demand 
records 

U*j 

5 

1-8 

MAXLAG 

18 

Maximum  time  a class  should  be 
lagged  before  it  starts  executing 
'extras'  tasks  instead  of  waiting 
for  correlation 

i 

1 f ] 

u 

9-16 

IOPTF 

18 

If  IOPTF=0,  stop  if  there  is  not 
enough  resource  available  to  sat- 
isfy demands. 

If  IOPTF=l,  print  a message  and 
continue  execution  if  not  enough 
resource  is  available  to  satisfy 
demands . 

If  IOPTF=2,  lag  classes  if  not 
enough  resource  is  available  to 
satisfy  demands 

17-24 

IOPTF1 

18 

Not  used 

25-32 

IOPTF2 

18 

If  IOPTF2=0,  stop  if  synchroni- 

zation  or  correlation  is  impos- 
sible at  some  time. 

If  I0PTF2=1,  print  a message 
and  continue  if  synchronization 
or  correlation  is  impossible  at 
some  time. 

If  IOPTF2=2,  lag  classes  that 
could  not  be  synchronized  or 
correlated. 


6 

1-8 

NCGRPS 

18 

Number  of  course  groups 

7 to 

1-8 

NCING(I) 

18 

Number  of  courses  in  Ith  group 

6+NCGRPS 
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CARD  COL. 

VARIABLE 

FORMAT 

DESCRIPTION 

9-16 

ICING(l.I) 

18 

1st  course  in  Ith  group 

17-24 

ICING(2, I) 

18 

2nd  course  in  Ith  group 

65-72 

ICING(8,I) 

18 

8th  course  in  Ith  group 

3.3.2  Training  Demand  Records 

Training  demand  records  are  written  out  by  the  Phase  2 TRAM  program 
on  either  tape  or  disk.  They  are  6 words  long  and  written  without  using  a 
format  statement. 

Before  use  in  Phase  3 of  TRAM,  the  training  demand  records  are 
sorted  on  time  in  decreasing  order. 

3.3.3  Resource  Inventories 

The  resource  inventory  records  are  written  out  by  the  Phase  2 TRAM 
program  on  either  disk  or  tape.  They  are  3 words  long  and  written  without 
using  a format  statement. 

The  resource  records  are  sorted  in  decreasing  order  by  time. 

3.3.4  Trainee  Inventories 

The  source  records  describe  the  trainee  inventories.  These  records 
are  written  by  the  Phase  2 TRAM  program  on  either  disk  or  tape.  They  are  3 

words  long  and  are  written  without  using  a format  statement. 

The  source  records  are  sorted  in  decreasing  order  by  time. 

3.3.5  Description  of  Training  Program 

The  Training  Program  (also  referred  to  as  courses)  is  described  by 
means  of  Procblocs,  Task  Blocks,  Resource  Utilization  Blocks  and  Resource 
Utilization  Description  Blocks.  The  detailed  formats  of  these  data  blocks 
are  given  in  the  programmer's  guide,  Technical  Memorandum  SAT-6. 

These  blocks  are  read  into  core  from  FORTRAN  Unit  20  when  the  CLOCK 
subroutine  is  invoked  for  the  first  time.  The  addresses  of  the  first  procbloc 
for  each  course  (the  Graduation  Block)  are  stored  in  array  IADPBI  in  common 
CBLK.  Each  procbloc  points  to  the  procbloc  (s)  lying  to  the  left  and  right  of 
it  and  to  the  tasks  associated  with  it.  Task  blocks  point  to  RUBs  and  RUBs. 
in  turn  point  to  the  RUDBs . This  linked  structure  permits  quick  access  (using 
subroutine  BLOCK)  to  information  required  for  performing  the  different  func- 
tions of  the  program  (i.e..  Class  Transfer  Tasks,  Resource  Utilization  Tasks, 
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etc. ) 

3.4 

DESCRIPTION  OF  OUTPUTS 

The 

outputs  of  the  Phase  3 TRAM  program  consist  of 

1. 

Echo  of  the  inputs 

2. 

Resource  inventories  remaining  after  training 
demands  have  been  satisfied. 

3. 

Trainee  (Source)  inventories  remaining  after 
training  demands  have  been  satisfied. 

4. 

Lag  records. 

5. 

Source  allocation  records. 

6. 

Warning,  error  and  normal  end  messages. 

3.4.1  Resource  Inventories 


The  output  resource  inventory  records  are  identical  in  form  to  the 
input  resource  inventory  records. 

The  input  inventory  minus  the  output  inventory  for  any  given  time 
interval  is  the  amount  of  the  resource  consumed  during  that  time  to  satisfy 
the  training  requirements. 

3.4.2  Source  Inventories 

The  output  source  inventory  records  are  identical  in  form  to  the 
input  source  inventory  records. 

The  input  inventory  minus  the  output  inventory  for  any  time  interval 
is  the  number  of  trainees  from  that  particular  source  actually  assigned  to  the 
training  program  during  that  time  interval. 

3.4.3  Lag  Records 

The  lag  records  are  written  out  on  tape  or  disk  by  the  Phase  3 TRAM 
program  whenever  a class  has  to  be  lagged. 

Note  - Processing  in  TRAM  3 is  done  in  reverse  time  order,  (i.e., 
last  PROCBLOC  of  a course  is  done  first,  first  PROCBLOC  is  done  last.)  Thus, 
when  a class  is  lagged,  the  net  effect  is  to  force  something  to  occur  at  an 
earlier  date. 
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Class  blocks,  stored  in  common  CLASSB,  are  created  for  each  new 
&ntS  enterin2  a course  at  ^e  graduation  block  and  for  every 

Jie  H^LJ%eX1S!in8i-' las\is  sPUt  amon2  different  tracks.  Class  blocks 
are  deleted  from  the  list  whenever  a procbloc  without  a left  branch  is  ex- 
ecuted. Subroutine  NEWCLS  creates  class  blocks  and  subroutine  REMCLS  deletes 


Predetermined  transfer  blocks,  stored  in  common  PTBC,  are  created 
by  subroutine  FRMPTB  when  a source  allocation  task  (SCATSA)  is  executed  The 
pointer  to  the  first  PTB  is  placed  in  the  class  block.  Afier  a TbTus  J 

i“n7  3 CiaSS  ^ransfer  at  a node*  i1:  is  deleted  and  the  space  it  used  is 

ITX  ttSne*“  REMPTB'  THC  P°inter  in  the  Cla”  M°ak  » 

Look-up  and  updates  of  resource  and  source  inventories  are  done  bv 
using  subroutines  GETRES.  PUTRES,  GETSOR  and  PUTSOR.  Resource  and  source  in- 

Ihe  f^t  ?”StTVn„tape  " diSk-  Khen  ^routine  clock  is  called  for 
e irst  time,  the  buffers  allocated  to  the  inventories  are  filled  with  data 

s arting  at  the  simulation  clock  time  and  extending  as  far  back  as  space  nT- 

timei  kV!7  ,T  !‘  e subroutine  clock  is  called,  inventory  records  for 
imes  greater  than  the  simulation  clock  time  are  written  out  on  tape  or  disk 
and  the  core  thus  made  available  is  used  to  read  in  resource  and  source  in- 
ventones  for  an  earlier  time. 


Checking  for  input  errors  is  done  primarily  in  Phases  1 and  2. 


During  the  execution  of  Phase  3 checks  are  made  to  make  sure  that  the 
dimensions  of  the  work  arrays  are  not  exceeded.  When  a dimension  overrun  does 
occur,  the  program  stops  after  printing  an  appropriate  error  message.  In  most 
cases  a recompilation  of  the  program  specifying  larger  dimensions  will  be  re- 
quired. It  is  suggested  that  the  'VARY’  program  be  used  for  effecting  the  di- 
mension change. 

The  Phase  3 TRAM  program  performs  a large  number  of  redundant  checks 
on  the  data  during  processing.  When  an  error  is  detected,  the  program  prints 
an  error  message  and  stops.  In  the  list  of  messages,  these  errors  are  marked 
'Program  Bug'  because  that  is  what  they  would  be:  program  bugs.  During  the 

final  testing  and  running  of  the  program,  none  of  these  error  conditions  have 
occurred,  and  are  not  planned  to  occur  under  any  foreseen  circumstances.  If 
any  of  these  errors  ever  occur,  then  either  the  system  malfunctioned  or  a 
serious  program  error  occurred  in  TRAM,  which  will  require  a programmer  for 
interpretation. 

The  following  is  a complete  list  of  the  possible  stops  and  the 
recovery  procedures. 

1.  ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  1 IN  SUBROUTINE  ADDTDQ. 

STORAGE  LIMITS  EXCEEDED  FOR  COURSE  TRAINING  DEMAND  QUEUES  IN 
SUBROUTINE  ADDTDQ.  PROGRAM  MUST  BE  RECOMPILED. 

Array  ICORE  in  common  CTDQ  needs  a larger  dimension. 

Variable  LIMIT1  in  common  CTDQ  should  contain  the 
dimension. 

2.  ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  2 IN  SUBROUTINE  ADDTDQ. 

ERROR  ADDTDQ  511.  ILLEGAL  COURSE  NUMBER  NNN  MAXIMUM  IS  MMM. 

Program  Bug.  (See  Section  3.4.4)., 

3.  ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  3 IN  SUBROUTINE  ADDTDQ. 

JUNK  IN  STORAGE  FOR  TRAINING  DEMAND  RECORDS.  II FREE  = NNNN 

Program  Bug.  (See  Section  3.4.4). 

4.  ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  4 IN  SUBROUTINE  ALLOC. 

PROGRAM  ERROR  SUB.  ALLOC.  IGSTME, ITIME1 , ITIME2  = NNN, NNN, NNN 

Program  Bug.  (See  Section  3.4.4). 

5.  ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  5 IN  SUBROUTINE  ALLOC. 

ILLEGAL  VALUE  RETURNED  BY  GETSOR.  NSORCE , IGSTME , ITIME1 , ITIME2 , 

INVSRC  ^ NNN  NNN  NNN  NNN  NNN 

Program  Bug.  (See  Section  3.4.4). 


y 

o 

u 


! 


15.  ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  15  IN  DTRNSF . 

ERROR  401  DTRNSF.  MORE  TUAN  1 FORWARD  BRANCH  IN  PROCBLOC. 

Error  message  is  followed  by  a listing  of  the  erroneous 
PROCBLOC. 

Correct  inputs  to  step  1 to  insure  that  a tree  structure  is 
followed  for  the  course  description. 

Rerun  steps  1,2  and  3. 

16.  ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  16  IN  SUBROUTINE  EXECT. 

ILLEGAL  TASK  FUNCTION  NNN  IN  PROCBLOC  III. 

Correct  the  task  function  name  in  the  inputs  to  step  1 
and  rerun  steps  1,2  and  3. 

1',  . ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  17  IN  SUBROUTINE  EXECT 

TASK  FAILURE.  PROGRAM  STOP  IN  EXECT. 

Error  message  is  followed  by  listing  of  the  class  block  and 
the  task  block. 

Either  insure  that  enough  resource  inventory  is  available  to 
satisfy  demands  or  select  the  CONTINUE  or  LAG  options  for  the 
bypassing  of  this  error  type. 

18.  ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  18  IN  SUBROUTINE  CORR. 

NO  SYNC  LINK  IN  PROCBLOC. 

Error  message  is  followed  by  a listing  of  the  PROCBLOC  in 
error. 

User  specified  a CORR  task  for  the  PROCBLOC  that  was  not  in- 
cluded in  a synchronization  loop. 

Correct  input  to  step  1 and  rerun  steps  1,2  and  3. 

19.  ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  19  IN  SUBROUTINE  FRMPTB . 

ERROR  FRMPTB  411.  TRAINEES  ASSIGNED  TO  WRONG  TDB  NUMSTA,  NUMBLK, 
NPROCB  = NNN  NNN  NNN 

Program  Bug.  (See  Section  3.4.4. )• 

20.  ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  20  IN  SUBROUTINE  GENTDB . 
PROGRAM  ERROR.  SUB.  GENTDB.  ISRCE1 ,NOSRCS  = NNN  NNN 

Arrays  in  common  SORDSC  need  larger  dimensions. 

21.  ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  21  IN  SUBROUTINE  GENTDB. 
ILLEGAL  NUMBER  OF  FORWARD  BRANCHES  IN  PROCBLOC. 

Error  message  is  followed  by  a listing  of  the  erroneous 
PROCBLOC. 

Correct  inputs  to  step  1 to  insure  that  a tree  structure  is 
followed  for  the  course  description. 

Rerun  steps  1,2  and  3. 


93 


..........  - 


I 


22. 


ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  22  IN  SUBROUTINE  GENTDB . 
ILLEGAL  NUMBER  OF  LEFT  BRANCHES  IN  PROCBLOC. 
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23. 


24. 


25. 


26. 


27. 


28. 


li 


Error  message  is  followed  by  a 
PROCBLOC. 


listing  of  the  erroneous 


ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  23  IN  SUBROUTINE  GENTDB. 
BACK  POINTER  DOES  NOT  MATCH  PREVIOUS  PROCBLOC. 

Error  message  is  followed  by  listings  of  the  two  erroneous 
PROCBLOCS . 

Program  Bug  (See  Section  3.4.4). 


ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  24  IN  SUBROUTINE  GENTDB. 
COURSE  DIMENSIONS  EXCEEDED.  NCOURS  = NNN 


Arrays  in  common  CBLK  need  to  increased. 


ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  25  IN  SUBROUTINE  LSTASK. 

ILLEGAL  TASK  FUNCTION, NPROCB,  ITASK,ITSKFN  = NNN  NNN  NNN 

Correct  the  name  of  the  task  function  in  the  inputs 
to  step  1 and  rerun  steps  1,  2 and  3. 

ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  26  IN  SUBROUTINE  LSTSRC. 

SOURCE  PROCBLOC  WITHOUT  A GETSOURCE  TASK. 

Error  message  is  followed  by  a list  of  the  erroneous  PROCBLOC. 
Correct  inputs  to  step  1 to  insure  that  all  source  PROCBLOCS 
contain  a 'GETSOURCE'  task. 

Rerun  steps  1,2  and  3. 

ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  27  IN  SUBROUTINE  LSTSRC. 

SOURCE  PROCBLOC  HAS  MORE  THAN  1 GETSOURCE  TASK. 

Error  message  is  followed  by  a list  of  the  erroneous  PROCBLOC. 
Correct  inputs  to  step  1 to  insure  that  all  source  PROCBLOCS 
contain  one  and  only  1 'GETSOURCE 'task. 

Rerun  steps  1,2  and  3. 

ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  28  IN  SUBROUTINE  LSTSRC. 

SOURCE  PROCBLOC  HAS  INVALID  NUMBER  OF  TASKS. 

Error  message  is  followed  by  list  of  erroneous  PROCBLOC 
Program  Bug  (See  Section  3.4.4). 


29.  ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  29  IN  SUBROUTINE  LSTSRC 

NUMBER  OF  PROCBLOCS  IN  COURSE  EXCEED  WORKING  STORAGE  IN  SUBROUTINE 
LSTSRC . 

Either  increase  the  dimension  of  array  IADRSB  in  subroutine 
LSTSRC  or  reduce  the  maximum  number  of  PROCBLOCS  in  each  course 
to  fit  the  dimension. 


I 
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6.  ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  6 IN  SUBROUTINE  ALLOCA 
PROGRAM  ERROR.  SUB.  ALLOCA.  NASGND.NUMSTD  = NNN  NNN 

Program  Bug.  (See  Section  3.4.4). 

7.  ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  7 IN  SUBROUTINE  ALLOCD 
PROGRAM  ERROR.  SUB.  ALLOCD.  NASGND.NUMSTD  = NNN  NNN 

Program  Bug.  (See  Section  3.4.4). 

8.  ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  8 IN  SUBROUTINE  CALQ. 

ILLEGAL  RESOURCE  UTILIZATION  GROUPING  FUNCTION  NNN 

Program  Bug.  (See  Section  3.4.4). 

9.  ERROR  IN  STEP  3 of  TRAM.  ERROR  NUMBER  9 IN  SUBROUTINE  CALQ. 

ILLEGAL  RESOURCE  UTILIZATION  TIMING  FUNCTION  NNN 

Correct  input  to  step  1 and  rerun  steps  1,  2 and  3. 

10.  ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  10  IN  SUBROUTINE  FORMC 
ERROR  601.  SUB  FORMC.  ARRAY  LIMITS  EXCEEDED. 

Arrays  in  common  WRKA  need  a larger  dimension. 

Variable  LIMTR  in  common  WRKA  should  contain  the  dimension. 


ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  11  IN  SUBROUTINE  CORR 
PROCBLOC  NNN  HAS  THE  FOLLOWING  NNN  CLASSES  ASSOCIATED  WITH  IT 
NNN  NNN  NNN  ... 

Program  Bug.  (See  Section  3.4.4). 

ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  12  IN  SUBROUTINE  CORR 
COURSE  NUMBER  IN  CLASS  BLOCK  IS  NNN  BUT  COURSE  NUMBER  IN 
PROCBLOC  IS  NNN. 

Error  message  is  followed  by  a dump  of  the  linked  class 
block  storage  area  and  the  PROCBLOC  involved. 

Program  Bug.  (See  Section  3.4.4), 

ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  13  IN  SUBROUTINE  DETLAG. 
ERROR  401.  SUB  DETLAG.  ARRAY  LIMITS  EXCEEDED. 

NXT.LIMNXT  = NNN  NNN 

Array  INVRES  in  common  RES  needs  a larger  dimension. 
Variable  LIMN XT  should  contain  the  dimension. 

ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  14  IN  DETLAG. 

ERROR  501.  SUB  DETLAG.  BAD  TIMES  RETURNED  BY  GETRES. 

IPTIME, ITIMEC, LOTI, L0T2  = NNN  NNN  NNN  NNN 

Program  Bug.  (See  Section  3.4.4), 
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ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  30  IN  SUBROUTINE  LSTSRC . 

MORE  THAN  1 RUDB  SPECIFIED  FOR  SOURCE. 

Error  message  is  followed  by  listings  of  the  PROCBLOC,  task 
block  and  resource  utilization  blocks.  Correct  the  inputs 
to  stepl  to  insure  that  only  1 source  is  called  for  by  the 
'GETCOURSE'  task. 

Rerun  steps  1,2  and  3. 

ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  31  IN  SUBROUTINE  LSTSRC. 
ALTERNATE  RUDBS  AND  SECONDARY  RUBS  ARE  NOT  PERMITTED  FOR  SOURCES. 

Error  message  is  followed  by  listing  of  PROCBLOC,  task  block, 
resource  utilization  block  and  resource  utilization  descrip- 
tion block. 

Correct  inputs  to  step  1 and  rerun  steps  1,  2 and  3. 

ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  32  IN  SUBROUTINE  NEWCLS  . 

LIMITS  FOR  CLASS  STORAGE  ARRAYS  EXCEEDED. 

Error  message  is  followed  by  a dump  of  the  class  block  storage 
array. 

Array  ICLASS  in  common  CLASSB  needs  a larger  dimension. 
Variable  LIMITC  in  common  CLASSB  should  contain  the  value-  of 
the  dimension. 

ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  33  IN  SUBROUTINE  PBLOCK. 

Last  PROCBLOC  printed  did  not  have  a '1'  in  the  block  type 
entry. 

ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  34  IN  SUBROUTINE  PREPC. 

LIMITS  FOR  CURRENT  CLASS  STORAGE  EXCEEDED. 

Error  is  followed  by  a dump  of  the  class  block  storage  array. 
Arrays  in  common  CCLS  need  a larger  dimension. 

Test  in  the  IF  statement  following  statement  number  110  in 
PREPC  should  be  modified  to  reflect  the  larger  dimension. 

ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  35  IN  SUBROUTINE  REMCLS . 

BAD  LINKS  IN  CLASS  STORAGE. 

Error  message  is  preceeded  by  a dump  of  the  class  block 
storage  array. 

Program  Bug.  (See  Section  3.4.4). 

ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  36  IN  SUBROUTINE  REMPTB . 

BAD  LINKS  IN  PTB  STORAGE. 

Error  message  is  preceeded  by  a dump  of  the  predetermined 
transfer  blocks  storage  array. 

Program  Bug.  (See  Section  3. 4.  4) . 
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ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  37  IN  SUBROUTINE  RESINV. 
ERROR  RESINV  1101.  INVALID  TIME  RETURNED  BY  GETRES. 


IRESNO 

LITIM1 

LITIM2 

NNNN 

NNNN 

NNNN 

LOTIM1 

LOTIM2 

NXT 

NXT1 

NB 

NNNN 

NNNN 

NNNN 

NNNN 

NNNN 

I 

INVRES 

NN 

NNN 

Program  Bug.  (See  Section  3.4.4). 

ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  38  IN  SUBROUTINE  RESINV. 

ERROR  RESINV  1201.  DIMENSION  OF  ARRAY  INVRES  EXCEEDED. 

NXT  = NNNN) 

Array  INVRES  in  common  RES  needs  a larger  dimension. 

Variable  LIMNXT  should  contain  the  value  of  the  dimension. 

ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  39  IN  SUBROUTINE  RESUSE. 

AT  TIME  NNNN  RESOURCE  NUMBER  NNN  WAS  EXHAUSTED.  PROGRAM  STOP. 

Either  insure  that  enough  resource  inventory  is  available  to 
satisfy  demands  or  select  the  CONTINUE  or  LAG  options 
(IOPTF^I  or  2)  for  bypassing  errors  of  this  type. 

ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  40  IN  SUBROUTINE  RESUSE. 

AT  TIME  NNNN  RESOURCE  NUMBER  NNNN  WAS  EXHAUSTED.  EXECUTION  CONTINUES. 

Warning.  Final  resource  inventories  will  not  reflect  true 
consumption.  Either  increase  the  scarce  resources  or  select 
the  LAG  option  (IOPTF=2) . 

ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  41  IN  SUBROUTINE  RESUSE 
AT  TIME  NNNN  RESOURCE  NUMBER  NNNN  WAS  EXHAUSTED.  PROGRAM  STOP 

Same  as  #39  (but  is  for  primary  resources) . 

ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  42  IN  SUBROUTINE  RESUSE. 

AT  TIME  NNNN  RESOURCE  NUMBER  NNNN  WAS  EXHAUSTED.  EXECUTION  CONTINUES, 

Same  as  #40  (but  is  for  primary  resources) . 

ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  43  IN  SUBROUTINE  RUSER. 

PGM. ERROR. RUSE R 411.  ITOTQ  = N 

Program  Bug.  (See  Section  3.4.4). 

ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  44  IN  SUBROUTINE  SCATSA. 

ERROR  411  SCATSA.  NO  TDBS  FOR  COURSE  n,Ll,L2=  n n 
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45. 


ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  45  IN  SUBROUTINE  SCATSA. 
ERROR  421.  SCATSA.  ALL  SOURCES  EXHAUSTED.  NUMERS, ICLSTM, 
NDXCLS  = n n n 
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46. 


47. 


48. 


49. 


50. 


Correct  inputs  to  step  1 to  insure 
track (s)  of  each  course  provide  an 
supply  of  trainees. 


that  the  lowest  priority 
essentially  infinite 


ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  46  IN  SUBROUTINE  SPLIT. 

ERROR  SPLIT  521.  WRONG  PROPORTIONS  IN  PREDETERMINED  TRANSFER  BLOCK. 


NUMCRS 

NOSTDS 

IPRTYC 

ICLSTM 

NPROCB  ISTATS  IPREDT 

n 

n 

n 

n 

n n n 

I 

PROP 

NEXTPT 

n 

n 

n 

Program  Bug.  (See  Section  3.4.4). 

ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  47  IN  SUBROUTINE  SVRUS1 . 

ERROR  301.  SUBSVRUS1.  ARRAY  LIMITS  EXCEEDED. 

NSAVE, ISAVE, INDX1, INDIX2, LIMIS, LIMNS  = n n n n n n 

If  NSAVE  is  greater  than  or  equal  to  LIMNS  then  arrays 
IADI1,IADI2  and  IADS1  need  larger  dimensions. 

If  (ISAVE+INDX2-INDX1+1)  is  greater  than  or  equal  to  LIMIS 
then  array  IAUSED  needs  a larger  dimension. 

Variables  LIMNS  and/or  LIMIS  should  be  changed  to  reflect 
the  increased  dimensions, 

ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  48  IN  SUBROUTINE  SYNC. 

NO  SYNC  LINK  IN  PROCBLOC 

Error  message  is  followed  by  list  of  erroneous  PROCBLOC. 

A SYNC  task  was  specified  for  a PROCBLOC  that  is  not  included 
in  a synchronization  loop.  Correct  inputs  to  step  1 to  insure 
that  all  PROCBLOCS  having  SYNC  or  CORR  tasks  are  part  of 
closed  synchronization  loops.  Rerun  steps  1,2  and  3. 

ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  49  IN  SUBROUTINE  SYNC 
PROCBLOC  n HAS  THE  FOLLOWING  n CLASSES  ASSOCIATED  WITH  IT 

Program  Bug.  (See  Section  3.4.4). 

ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  50  IN  SUBROUTINE  SYNC 
COURSE  NUMBER  IN  CLASS  BLOCK  IS  n BUT  COURSE  NUMBER  IN  PROCBLOC  IS  n 

Error  message  is  followed  by  a dump  of  the  class  blocks 
linked  storage  and  a listing  of  the  erroneous  PROCBLOC 
Program  Bug.  (See  Section  3.4.4). 
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51.  ERROR  IN  STEP  3 OF  TRAM  ERROR  NUMBER  51  IN  SUBROUTINE  TBLOCK. 

The  task  block  printed  last  does  not  have  a '2'  in  the 
'block  type'  field. 

Program  Bug.  (See  Section  3.4.4). 

52.  PROGRAM  ERROR.  CURRENT  TIME  NOT  DECREMENTED. 

LSTIME, ITIMEC=  n n 

LIST  OF  ACTIVE  CLASSES 

IN  STEP  3 OF  TRAM.  ERROR  NUMBER  52  IN  SUBROUTINE  TRAM3 
Program  Bug.  (See  Section  3.4.4). 

IN  STEP  3 OF  TRAM.  ERROR  NUMBER  53  IN  SUBROUTINE  WRUB 

The  resource  utilization  description  block  printed  last 
does  not  have  a 3 in  the  'block  type'  field. 

Program  Bug.  (See  Section  3.4.4). 

IN  STEP  3 OF  TRAM.  ERROR  NUMBER  54  IN  SUBROUITNE  WRIJDB. 

The  resource  utilization  description  block  printed  last 
does  not  have  a '4'  in  the  'block  tvpe'  field. 

Program  Bug.  (See  Section  3.4.4). 

55.  STEP  3 OF  TRAM  COMPLETED  NORMALLY. 

Normal  job  termination  message. 

56.  ERROR  IN  STEP  3 of  TRAM.  ERROR  NUMBER  56  IN  SUBROUTINE  INIT. 

ILLEGAL  SIMULATION  START  AND/OR  STOP  TIMES.  ITIMES,  ITIMEE=  n n 

Correct  input  card  and  rerun  Step  3 

ITIMES  must  be  less  than  ITIMEE  and  not  less  than  zero. 

ITIMEE  must  be  less  than  99999 

57.  ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  57  IN  SUBROUTINE  INIT 
ILLEGAL  FORTRAN  INPUT  UNIT  FOR  TRAINING  DEMAND  RECORD.  ITRNRU  = n 

Correct  input  card  and  rerun  Step  3 
Permissible  value  range  is  1-99 

58.  ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  58  IN  SUBROUTINE  INIT 

ILLEGAL  VALUE  FOR  MAXIMUM  CORRELATION  LAG.  MAXLAG=  n 


ERROR 

53.  ERROR 

54.  ERROR 


0 


Correct  input  card  and  rerun  Step  3 
Permissible  value  range  is  0-1000 
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ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  59  IN  SUBROUTINE  INIT. 
ILLEGAL  OPTIONS  SELECTED.  IOPTF,  IOPTF2  ■ n n 

Correct  input  card  and  rerun  Step  3 
Permissible  value  range  is  0-2 


ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  60  IN  SUBROUTINE  INIT. 
ILLEGAL  NUMBER  OF  COURSE  GROUPS.  15  IS  MAXIMUM  ALLOWED. 
NCGRPS  = n 


Correct  input  card  and  rerun  Step  3 


ERROR  IN  STEP  3 OF  TRAM.  ERROR  NUMBER  61  IN  SUBROUTINE  INIT. 
ILLEGAL  COURSE  NUMBER  IN  LIST  = n n n n 

Correct  input  card  and  rerun  Step  3 
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4-  MERGI  FROG  RAM 

4 . 1 PURPOSE 

The  purpose  of  this  program  is  to  merge  the  original  resources  file 
from  phase  2 ami  the  unused  resources  file  from  phase  3 into  a single  resource 
use  file  for  input  to  phase  4. 

4.2  DESCRIPTION' 


The  merge  program  reads  matched  pairs  of  records  from  the  two  input 
merge  files,  and  outputs  single  records  containing  the  data  from  the  original 
pair.  There  are  no  inputs  to  this  program  other  than  the  binary  files  passed 
from  the  earlier  TRAIN  job  steps  (files  23,  24  and  33).  The  main  output  is  also 
a binary  file,  which  is  passed  to  phase  4.  The  only  printed  output  consists  of 
diagnostic  error  messages,  or  the  message  "MERGE  COMPLETED",  which  indicates 
that  no  errors  were  detected. 

4 . 3 MERGE  PROGRAM  ERROR  MESSAGES 

* * ERROR*  * NO'  1 BE R OE  RESOURCES  EXCEEDS  MAXIMUM 

The  merge  program  docs  not  have  enough  storage  to  process  all  of  the 
resources.  The  program  will  have  to  be  re-compiled  to  increase  the  array  di- 
mensions . 
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**ERkOR* ‘RECORD  IS  MISSING  FROM  FILE  23 

A record  on  file  33  was  read  that  logically  precedes  the  last  record 
read  from  file  23.  This  problem  should  never  occur,  but  could  be  caused  by  an 
abnormal  condition  during  TRAM  phase  2,  phase  3 or  the  sort  steps  for  the  two 
files . 


**n 


ERROR* ‘RECORD  READ  ON  FILE  23  BEFORE  ITS  EXPECTED  TIME 


The  expected  time  is  the  time  of  the  last  record  for  that  resource, 
plus  its  bucket  size.  This  problem  should  never  occur,  but  abnormal  condition 
during  TRAM  phase  2,  or  in  the  sort  step  for  file  23. 
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PHASE  4 
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5.1  PURPOSE 

The  purpose  of  the  Phase  4 TRAM  program  is  to  develop  the  costs  associ- 
ated with  the  training  system.  The  costs  are  presented  in  current  dollars  and  in 
then-year  dollars,  assuming  a constant  compounded  inflation  rate.  The  then-year 
dollars  can  also  be  used  to  discount  future  costs  by  means  of  negative  inflation 
rates . 

5.2  DESCRIPTION 


The  Phase  3 TRAM  program  provides  a time  history  of  training  resource 
usage  in  buckets.  A bucket  is  a time  period  that  is  on  the  order  of  a student's 
near  term  planning  horizon  so  as  to  avoid  the  detailed  (micro)  scheduling  of  re- 
sources, but  still  preserve  problems  in  resource  allocation.  These  buckets  are 
far  too  small  for  planning  purposes,  so  they  are  summarized  by  the  reporting 
period.  The  phase  4 TRAM  has  a user  specified  periodic  reporting  period  and  an 
automatic  yearly  reporting  period.  The  periodic,  reporting  period  can  be  either 
greater  or  less  than  the  yearly  period,  to  obtain,  for  example,  quarterly  reports 
or  5-year  summaries. 

In  order  to  (1)  properly  treat  simulators  and  trainers  that  can  be  sep- 
arated into  components  for  individual  training  or  combined  to  provide  full  or 
partial  crew  training,  and  (2)  allow  computation  of  facility  related  costs,  the 
concepts  of  resource  generating  units  (RGU) , primary  resources,  secondary  re- 
sources, and  resource  generator  components  must  be  introduced.  A primary  resource 
for  the  purposes  of  Phase  4 is  a resource  whose  use  is  determined  by  Phase  3. 

(Phase  3 has  secondary  resources  as  well.)  Secondary  resources  are  used  in  both 
programs  to  simplify  coding  of  the  use  of  resources  such  as  simulators  that  have 
associated  (secondary)  use  of  personnel,  facilities,  utilities,  etc.  An  RGU 
is  a device  such  as  a trainer  that  generates  some  number  of  resource  units  in  a 
bucket.  For  example,  the  resource  is  trainee  contact  hours  and  the  resource  gen- 
erator device  is  the  trainer.  A resource  generator  unit  can  correspond  to  a single 
real  unit  such  as  a simulator,  but  could  also  refer  to  multiple  devices  such  as  a 
room  full  of  carrels. 


A resource  generator  component  is  a part  of  an  RGU  that  is  separable. 
It  is  envisioned  that  resource  components  will  be  used  to  treat  the  special 
problem  of  computing  the  use  of  trainers  that  have  multiple  display  panels 
using  a single  display  board  and  computer,  and  for  computing  the  use  of  sep- 
arable trainers  and  simulators.  For  example,  if  the  DSO  station  is  used  tor 
30  hours  per  week,  the  full  crew  simulator  for  250  hours,  the  OSD  station  for 
120  hours  and  the  flight  station  (pilot  and  copilot)  for  200  hours,  the  number 
of  simulator  hours  required  is  450  since  the  combination  of  full  simulator  and 
flight  station  is  the  constraining  use  of  the  total  facility. 


Plots  of  the  use  of  any  of  the  resources  can  be  called  for  through 
the  inputs.  Resource-use  plots  indicate  the  average,  peak  and  available  levels 
of  use,  and  the  number  of  RGUs  required  as  a function  of  time. 


Hardware  once  purchased  is  assumed  to  last  throughout  the  training 
period  with  an  allowance  for  update,  repair  and  maintenance.  Instructional  per- 
sonnel are  RGUs  also.  Personnel,  once  assigned,  can  later  be  transferred.  How- 
ever, they  suffer  some  inertia  in  their  use.  It  is  assumed  that  a yearly  planning 
horizon  is  appropriate  for  such  RGUs.  If  so  indicated,  returnable  RGUs  are  ad- 
justed yearly  to  match  the  demand. 


Costs  developed  for  each  xesource  use  are  given  in  Table  5-1. 


TABLE  5-1 


COST  DATA 


• RDT5E 


One  time  if  resource  is  used 
Distributed  uniformly  over  N years 
before  the  first  delivery 


• Initial  Investment 


Based  on  a first-unit  cost  and  a cost- 

quantity  relationship 

Attributed  to  the  time  of  delivery 


• Recurring 
Investment 


Based  on  the  current  number  of  resource 
generator  units 


Recurring 

Investment 


Based  on  a yearly  charge  independent  of 
number  of  units  as  long  as  at  least  one 
unit  is  owned 


• Operations  $ 
Maintenance 


Based  on  the  current  number  of  resource 
generator  units 


• Operations  § 
Maintenance 


Based  on  the  current  use  of  the  resource 


I 


As  the  quantity  of  devices  increas,  the  cost  to  buy  and  maintain  per 

unit  decreases.  The  system  is  said  to  "learn"  how  to  make  or  use  the  device. 

The  learning  ratio,  L , is  the  ratio  of  the  average  cost  of  N units  to  the  av- 

K 

erage  cost  of  2N  units.  Normally  0.  < LR  < 1.  The  cost  of  N units  is 

C.,  = N x (cost  for  1 RGU)  x (Ln)L°g2  N 
N k 

The  learning  ratio  is  applied  to  Initial  Investment  per  RGU,  Recurring 
Investment  per  RGU  and  O+M  per  RGU.  To  have  the  learning  ratio  not  applied,  a 
negative  value  of  these  inputs  is  indicated.  In  this  case,  the  cost  of  N units 
is  given  by 

C.,  = N x (Cost  for  1 RGU) 

N 

If  RGUs  are  present  in  a given  year  and  M+N  units  are  required  in  the 
next  year,  the  initial  investment  for  the  additional  units  is  calculated  by 

CN  = CN+M  " CN 

Returnable  RGUs  are  returned  without  refund.  Should  they  be  later 
required,  a new  purchase  in  accordance  with  the  above  formulation  will  be  tallied. 

Summaries  of  time  phased  RDT§E,  Investment,  Recurring  Investment,  O&M 
and  totals  of  this  data  are  produced  in  current  and  then-year  dollars. 

• 

The  inputs  to  the  program  are  given  in  Table  5.2.  Table  5.2  contains  two 
examples,  which  illustrate  the  use  of  the  primary,  secondary  and  components  of 
resources.  Example  I represents  the  case  of  a DSO  Station  separable  Full  Mission 
Simulator  that  can  provide  only  one  "scenario"  at  a time;  thus  it  can  be  used 
separately  in  the  sense  of  operating  without  a pilot.  The  "control"  component  is 
an  essential  component  and  is  defined  for  all  of  the  parts  of  the  FULL  Mission 
Simulator.  The  components  other  than  the  control  unit  are  tallied  to  record  the 
use  of  each  station.  Example  II  is  for  a Better  Simulator  that  can  run  more  than 
one  problem  at  a time.  This  simulator's  use  is  determined  by  the  maximum  overall 
components  (in  contrast  to  Example  I where  the  use  is  determined  by  the  sum  of  all 
"Full  M,S.  - Control  Use.) 
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5 .3  INPUTS 

5. ,3.1  Files  From  Previous  TRAM  Programs 


The  phase  4 program  requires  two  files  that  were  wiitten  by  previous 
TRAM  job  steps.  The  first  of  these  is  the  resource  information  file,  which  was 
written  to  unit  24  by  phase  2.  The  other  is  the  resource  use  file,  which  was 
written  to  unit  40  by  the  merge  program. 

5. ,3. 2 Input  Card  Description 

The  input  cards  for  phase  4 have  fixed  format  fields,  and  a separate 
card  is  provided  for  each  type  of  information.  All  of  these  cards  have  a name 
field  reserved  in  columns  1-5.  This  field  is  used  to  identify  the  card  type. 
Coding  forms  for  each  of  these  cards  are  shown  on  the  following  pages.  A descrip- 
tion of  the  values  contained  on  these  cards  is  contained  in  the  program  descrip- 
tion (Section  5.2). 

The  parameter  card  must  always  be  the  first  card  of  the  input  deck. 

This  card  is  followed  by  the  primary  resource  definitions.  Each  primary  resource 
definition  consists  of  the  PR  header  card,  followed  by  the  number  of  SRC  use 
cards  that  was  specified  on  the  PR  card.  The  secondary  resource  definitions 
follow  the  primary  resource  definitions.  The  SR  header  card  supplies  similar 
information  pertaining  to  the  secondary  resource,  as  the  PR  header  card  did  for 
the  primary  resource.  The  SR  card  is  always  followed  by  one  SRC  name  card,  which 
contains  the  number  of  secondary  resource  component  names  that  were  specified 
on  the  header  card.  The  input  deck  must  be  ended  with  a final  card  consisting 
of  the  word  END  punched  in  the  first  field. 
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5.  4 OUTPUTS 

The  following  outputs  are  produced  by  phase  4: 

1.  INPUT  CARD  LISTING 

This  listing  shows  the  valurs  exactly  as  they  are  read  from  each 
card.  Any  errors  detected  in  the  inputs  will  be  flagged  by  error  messages. 

2.  PARAMETER  VALUES 

This  page  shows  the  values  of  the  parameters  used  by  the  program. 
The  parameters  consist  of  those  values  specified  on  the  parameter  card,  along 
with  the  number  of  calendar  units  per  year,  which  is  read  from  file  24. 

3.  PRIMARY  RESOURCE  DEFINITIONS 

This  printout  shows  the  primary  resource  definitions  in  a tabular 
format,  with  each  value  identified  by  a column  heading.  This  table  includes 
the  bucket  sizes  that  were  read  from  file  24  and  matched  with  the  primary  re- 
source definitions  in  the  card  inputs. 

4.  SECONDARY  RESOURCE  DEFINITIONS 

This  listing  is  a table  of  the  secondary  resources  that  were  speci- 
fied by  the  card  inputs,  and  is  similar  to  the  table  of  primary  resource  defi- 
nitions . 

5.  PERIODIC  REPORT 

This  report  summarizes  the  usage  of  the  primary  resources  during 
the  reporting  period. 

6.  YEARLY  REPORT 

This  report  summarizes  the  resource  usage  during  the  your,  and 
also  shows  the  costs  resulting  from  that  usage.  A separate  summary  is  printed 
for  primary  and  secondary  resources . 
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7.  FINAL  COST  SUKMARY 


This  report  is  printed  at  the  end  of  the  run,  and  summarizes  the 
costs  incurred  in  each  category  for  each  year.  The  costs  are  shown  in  both 
current  and  inflated  dollars.  The  report  will  go  back  into  negative  years,  if 
ROTE  cost  was  incurred  before  the  start  of  the  run. 


8.  USE  PLOTS 

These  plots  are  produced  for  each  primary  and  secondary  resource 
that  had  a 1 specified  in  the  plot  switch  field  of  the  input  cards.  Each  plot 
contains  four  curves:  the  actual  use  available,  the  maximum  use  available,  the 
amount  used,  and  the  number  of  RGUs  on  hand  for  the  resource. 
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9.  TEMPORARY  FILES 

Units  51  and  52  are  used  as  temporary  storage  for  plot  data.  These 
files  are  described  in  the  programmer's  guide. 
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5.5  ERROR  MESSAGES 

The  following  error  messages  may  be  produced  by  phase  4. 

“ERROR  IN  SUBROUTINE  FPLOT 

INSUFi  1C I ENT  STORAGE  AVAILABLE  FOR  PLOT  OF  PRIMARY  RESOURCE  - XX 
The  name  of  the  primary  resource  that  caused  the  error  is  given  by 
XX.  The  program  will  have  to  be  re-compiled  to  increase  the  array  dimensions. 
(From  Subroutine  FPLOT.) 

**ERROR  IN  SUBROUTINE  FPLOT 

INSUFFICIENT  STORAGE  AVAILABLE  FOR  PLOT  OF  SECONDARY  RESOURCE  - XX 
The  name  of  the  secondary  resource  that  caused  the  error  is  given  by 

XX.  The  program  will  have  to  be  re-compiled  to  increase  the  array  dimensions. 
(From  Subroutine  FPLOT.) 

“ERROR* ‘ABOVE  PRIMARY  RESOURCE  DOES  NOT  MATCH  WITH  ANY  FROM  PREVIOUS 
TRAM  STEP 

The  name  of  the  primary  resource  was  not  found  among  those  passed 
from  TRAM  phase  2 via  file  24.  (From  Subroutine  INIT.) 

* ‘ERROR**  CARD  IS  NOT  A SECONDARY  RESOURCE 

A card  has  been  encountered  while  reading  the  secondary  resource,  that 
is  not  a seocndary  resource  definition.  (From  Subroutine  INIT.) 

* ‘ERROR**  INSUFFICIENT  STORAGE  AVAILABLE  TO  STORE  PRIMARY  RESOURCES 
The  program  will  have  to  be  re- compiled  to  increase  the  array  dimen- 
sions. (From  subroutine  INIT.) 

* ‘ERROR**  INVALID  CARD  ID 

The  card  printed  immediately  above  this  error  message,  has  a card 

name  punched  in  columns  1-5  that  the  program  does  not  recognize.  (From  Subroutine 
INIT.) 

“ERROR**  INVALID  PARAMETER  CARD 

The  first  input  card  did  not  have  the  card  n^me  PARMS  punched  into 
columns  1-5.  (From  Subroutine  INIT) 


**ERROR**  NO  PRIMARY  RESOURCES  HAVE  BEEN  DEFINED 

No  processing  can  be  done  without  the  resource  definitions,  so  the 


program  halts.  (From  Subroutine  INIT.) 

* i 

**ERROR**  PRIMARY  RESOURCE  NOT  DEFINED  - XX 

The  primary  resource  named  XX,  was  passed  from  the  previous  TRAM 
step,  but  was  not  defined  by  the  card  inputs  for  this  step.  (From  Subroutine 
INIT.) 

. **ERROR**  RDTE  COSTS  HAVE  GONE  BEYOND  YEAR  NUMBER  XX 

RDTE  costs  have  been  incurred  in  a year  prior  to  the  year  given  by 
XX  (a  negative  number),  which  is  the  maximum  allowed.  If  the  inputs  are  correct, 
and  do  cause  these  costs  in  negative,  years,  the  program  will  have  to  be  re-com- 
piled to  increase  the  array  dimensions.  (From  Subroutine  RDTE) 

**ERROR**  SECONDARY  RESOURCE  COMPONENT  NAME  IS  UNDEFINED  - XX 

The  use  of  the  secondary  resource  component  XX  was  specified  by  a 
primary  resource,  but  was  never  defined.  (From  Subroutine  INIT.) 

** ERROR**  TOO  MANY  SECONDARY  RESOURCE  COMPONENTS  FOR  AVAILABLE 

STORAGE 

The  program  will  have  to  be  re-compiled  to  increase  the  array  dimen- 
sions (From  Subroutine  INIT.) 

**ERROR**  TOO  MANY  SECONDARY  RESOURCES  FOR  AVAILABLE  STORAGE 

The  program  will  have  to  be  re-compiled  to  increase  the  array  dimen- 
sions (From  Subroutine  INIT.) 
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6.1  PURPOSE 

The  purpose  of  Phase  5 of  TRAM  is  to  report  on  the  usage  of  trainees 
and  on  the  time  lags  that  occurred  in  the  training  system. 

6.2  DESCRIPTION 

This  program  produces  two  output  reports;  the  lag  report  and  the  source 
report.  Each  of  these  reports  is  produced  at  a periodic  interval  and  at  a yearly 
rate.  The  periodic  reports  are  independent  of  the  yearly  reports,  and  they  can 
be  suppressed  completely  by  specifying  a large  reporting  period.  In  addition, 
the  two  reports  are  printed  at  the  end  of  the  run  to  cover  the  period  from  the 
last  yearly  report  up  to  the  end  time  of  the  run. 

6.3  INPUTS 

Binary  Files 


The  following  two  files  are  required  for  input  to  Phase  5: 

20  - names  file  from  Phase  2 
31  - source  lag  file  from  Phase  3 

Card  Inputs 

A single  input  card  is  read  by  Phase  5.  A coding  form  for  this  card 
is  shown  on  the  next  page.  The  start  time  and  end  time  specify  the  period  over 
which  this  program  is  to  be  run.  The  periodic  reporting  period  gives  the  length 
of  time  between  the  periodic  reports,  and  the  number  of  calendar  units  per  year 
specifies  how  often  the  yearly  reports  are  to  be  produced. 

6.4  OUTPUTS 


L 


The  Phase  5 outputs  consist  of  two  printed  reports.  Samples  of  these 
reports  are  shown  on  the  following  pages. 
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Lag  Report 


The  lag  report  lists  each  course,  processing  block,  and  task  that  was 
logged  during  the  period  being  reported.  For  each  of  these,  the  amount  of  time 
logged  during  the  period,  and  the  total  lag  time  to  date  are  shown.  The  final 
lag  report,  which  is  produced  at  the  end  of  the  run,  gives  this  information  for 
all  those  that  were  lagged  at  any  time,  rather  than  just  those  that  occurred 
during  the  reporting  period.  1 

Source  Report 

The  source  report  gives  the  number  of  trainees  used  during  the  reporting 
period  and  their  average  training  time.  The  cumulative  totals  and  averages  are 
also  shown.  These  figures  are  listed  by  both  course  name  and  by  source  name. 

6.5  PHASE  5 ERROR  MESSAGES 

**ERROR  - INSUFFICIENT  STORAGE  AVAILABLE  FOR  LAG  REPORT 

The  program  will  have  to  be  re-compiled  to  increase  the  array  dimen- 
sions . 

** ERROR  - INSUFFICIENT  STORAGE  AVAILABLE  FOR  SOURCE  REPORT 

The  program  will  have  to  be  re-compiled  to  increase  the  array  dimen- 
sions. 
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7-  TROLIE  PROGRAM 


7-.l  PURPOSE 

The  purpose  of  the  TROLIE*  program  is  to  provide  a rapid  and  easy 
method  of  developing  the  costs  of  an  aircrew  training  system.  As  such,  it 
fits  into  the  sec  of  programs  collectively  known  as  TRAM,**  hence  the  acronym 
TROLIE.  TROLIE  uses  some  inputs  normally  provided  to  TRAM  and  can  creat  the 
input  data  used  ’oy  Phase  4 TRAM  to  make  an  economic  analysis  of  training  costs. 
Description  of  TRAM  phases  appear  elsewhere  in  this  report.  This  section 
describes  t lie  TROLIE  program. 

7.2  DESCRIPTION 

The  training  is  patterned  after  that  required  for  manning  the  B-l. 
Training  consists  of  an  initial  training  phase  called  CCTS  (Combat  Crew 
Training  Squadron)  and  a periodic  training  phase  called  PMT  (Proficiency 
Maintenance  Training).  There  are  five  courses  in  CCTS  --  pilots,  copilots, 

OSOs,  DSOs  and  Extras.  The  first  four  of  these  areB-1  aircrewmen.  Extras 
will  be  discussed  below.  Associated  with  each  type  of  trainee  are  tracks. 

A separate  track  is  assigned  to  each  source  of  trainees. 

Five  tracks  are  allocated  to  each  position.  Associated  with  each 
air  base  is  a set  of  PMT  tracks.  A given  PMT  track  can  serve  one  or  more 
air  bases. 

The  program  functions  for  an  input  number  of  years,  calculating  the 
aircrews  trained  and  the  resources  used.  A number  of  air  bases  are  defined  by 
names  and  the  PMT  tracks  which  the  airmen  at  that  base  attend.  Deliveries  are 
tallied  by  noting  the  base,  year  and  number  of  aircraft  delivered.  The  aircraft 
on  a base  determine  the  number  of  full  crews  at  that  base  by  the  input  crew 
ratio . 


* Training  Resources  Organized  for  Logical  integration  of  Expenses 

**  Training  Resources  Analytic  Model 
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Associated,  with  each  CCTS  track,  there  is  a source.  More  than 
track  can  use  the  same  source.  The  capacity  of  sources  is  defined  by  entries 
in  a matrix  giving  the  number  of  trainees  available  from  each  source  for  each 
year  of  interest. 

Resource  use  by  trainees  is  given  by  a matrix  which  is  the  amount 
of  each  resource  used  by  a unit  trainee  in  each  track.  A unit  trainee  in  PMT 
is  all  the  training  a full  crew  receives  in  a year.  In  CCTS  the  individual 
crewmembers  are  unit  trainees.  The  extras  are  treated  as  a trainee  pair. 

The  aircraft  deployed  at  a given  base  are  used  to  compute  the  number 
of  full  crews  at  that  base.  (Round-up  is  used  to  deal  with  fractional  crews.) 
Crews  are  required  from  CCTS  whenever  an  aircraft  is  delivered  or  when  an 
existing  crew  suffers  attrition.  Attrition  is  modeled  as  a proportion  of  the 
existing  crews  in  the  system  (round-off  is  used  to  deal  with  fractional  crews). 

Since  newly  deployed  crews  are  unlikely  to  suffer  attrition  immediately 
upon  completion  of  their  training,  a delay  (input)  is  inserted.  The  attrition 
in  a given  year  is  calculated  on  the  basis  of  the  crews  present  in  the  given 
delay  period  earlier. 

In  addition  to  normal  attrition,  the  copilot  position  suffers 
"attrition"  due  to  upgrading  to  pilot  (PUPs).  The  extra  copilots  which  must  be 
trained  are  called  extras.  They  are  treated,  as  pairs  so  that  half  of  the 
extras  can  act  as  pilot  to  the  other  half  in  instructional  blocks  which  involve 
flight -crew  coordination. 

The  number  of  extra  classes  is  half  (with  round-up)  of  the  number  of 
copilot  upgrades.  The  copilot  upgrade  is  the  preferred  source  of  pilot  trainees. 
The  source  data  for  copilot  upgrades  is  calculated  by  the  program. 

Output  consists  of  data  which  verifies  the  inputs,  the  time-phased 
training  demands,  the  time-phase  trainee  source  use,  and  the  time-phased 
resource  use. 

A data  set  can  be  written  which  is  functionally  equivalent  to  the 
TRAM  Phases  1 through  3.  Phase  4 of  TRAM  is  normally  run  in  conjunction  with 
TROLIF.  to  provide  cost  data. 
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7.3  INPUTS 

Card  1 
Card  2 


Card  3 
Card  4 


Card  Set 


Card  Set 


Input  data  are  indicated  in  Table  7-1, 

Contains  the  floating  point  (real)  data. 

Contains  the  fixed  point  (integer)  data.  The  first  year  date 
is  for  output  labeling.  The  number  of  calendar  units  per  year 
is  used  to  determine  the  year  in  which  deliveries  are  made  and 
to  be  passed  to  Phase  4 TRAM.  The  row  of  calendar  units  in  a 
year  must  be  greater  than  3. 

Contains  the  air  base  names,  one  per  card.  The  format  allows  for 
the  first  two  characters  to  be  in  columns  9 and  10.  Normally  TRAM 
input  cards  are  used.  In  this  case,  the  field  actually  starts  in 
column  11. 

Contains  three  inputs.  IDT  is  a two-card  list  of  PMT  track  numbers. 
The  arrays  ILTID  and  IUTID  are  indexed  on  air  base  and  point  to 
sections  of  the  PMT  track  list.  Let 
ILTID  * 1,  2,  4,  etc. 

IUTID  = 2,  3,  5,  etc. 

IDT  = 26,  27,  28,  29,  30,  etc. 

Then  air  base  1 uses  PMT  tracks  26  and  27,  air  base  2 uses  PMT 
tracks  27  and  28,  air  base  3 uses  PMT  tracks  26,  29,  and  30,  etc. 

is  a set  of  deliveries.  A variable  number  of  deliveries  can  be 
inserted.  The  list  can  be  terminated  by  an  END  card  but  any  set 
of  4 characters  not  equal  to  "DELI"  can  be  used.  The  card  format  is 
again  that  of  TRAM  where  the  first  field  of  10  in  a delivery  card 
reads  "DELIVERY  ". 

contains  the  source  index  list.  The  first  source  is  copilots. 

The  first  five  elements  are  for  the  5 pilots'  tracks,  the  next 
five  for  the  five  copilots'  tracks,  the  next  five  for  the  five  OSO 
tracks,  the  next  five  for  the  five  DSO  tracks  ar.d  the  final  five  for 
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the  five  extras  tracks.  Sources  are  chosen  in  order  of  their  track 
number  within  a given  position.  Sources  are  drawn  upon  in  the  order 
of  pilot,  copilot,  DSO,  0S0  and  extras.  PMT  tracks  have  their 
associated  air  base  as  the  source  and  are  not  input  explicitly. 

Card  Set  7 is  a matrix  of  trainee  sources  available,  with  one  or  two  cards 

required  per  year  depending  on  whether  there  are  more  or  less  than 
20  sources. 


Card  Set  8 is  a list  of  resource  names,  one  per  card.  This  is  used  for  heading 
data  and  to  pass  on  to  Phase  4 TRAM. 

Card  Set  9 is  the  resource  use  matrix,  one  card  (or  set  of  cards)  per  track. 

The  resource  use  is  for  a unit  class  which  is  1 for  normal  air 
crew  members,  2 copilots  for  extras  and  1 year's  training  for  a 
full  crew  for  PMT  tracks. 


INPUTS  TO  TRCL1E  MODEL 


NO  OP  YEARS  15 

FIRST  YEAR  1975 

NO  OF  AIRBASES  13 

NO  OF  SOURCES  12 

NO  OF  TRACKS  38 

NO  OF  RESOURCES  79 

CALENDAR  UN  ITS/YE AR  1500 
ATTRITION  DELAY  2 

ATTRITION  RATIO  C.3C 

CREW  RATIO  2.00 


PUP  UPGRADE  RATIO  0.20 
TAPES  ARE  TO  BE  PRODUCED 


AIRBASE  LIST 


BASE 

NAME 

ILP 

IUP 

TRACKS 

1 

TINKER 

1 

1 

26 

2 

ELLSWORTH 

2 

2 

27 

3 

BARKSDALE 

3 

3 

28 

4 

MINOT 

4 

4 

29 

5 

MCCONNEL 

5 

5 

30 

6 

W-RAMA 

6 

6 

31 

7 

DYESS 

7 

7 

32 

8 

KINCHFLOE 

8 

3 

33 

9 

CARSWELL 

9 

9 

34 

10 

GNDFORKS 

10 

10 

3b 

11 

MCGEE-TYS 

11 

11 

36 

12 

GRISSOM 

12 

12 

37 

13 

N1AG-FALLS 

13 

13 

38 

Figure  7.3.2  Airbase  List 
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0 

5 
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0 

0 
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10 

15 

15 

5 

0 

0 

0 

1983 

0 

0 

C 

0 

10 

15 

15 

8 

1984 

0 

0 

0 

0 

0 

0 

0 

7 

1985 

14 

0 

0 

0 

0 

0 

0 

0 

1986 

1 

0 

0 

0 

0 

0 

0 

0 

1937 

0 

0 

0 

0 

0 

0 

0 
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1988 

0 

0 

0 

0 

0 
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Figure  7.3.3  Yearly  Delivery  List 
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> SOURCE  AVAILA6ILITY<==: 
SOURCE  ==> 


1 

2 

3 

A 

1976 

0 

12 

96 

9999 

1977 

0 

12 

96 

9999 

1978 

0 

12 

96 

9999 

1979 

0 

12 

96 

9999 

1900 

0 

12 

96 

9999 

1961 

0 

12 

96 

9999 

1982 

0 

12 

96 

999r 

1983 

0 

12 

96 

99 

198  A 

0 

12 

96 

r 

1985 

0 

12 

96 

1986 

0 

12 

96 

1987 

0 

12 

96 

1988 

0 

12 

96 

1989 

0 

12 

9 f 

1990 

0 

12 

f 

Figure  7.3.5  Source  Availability  Matrix 
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1 

0 

0 

0 

2 

89 

43 

31 

3 

96 

40 

43 

4 
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63 

48 

5 
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0 

0 
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40 

43 

7 

2 

68 
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35 

50 
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17 

45 

60 

0 

18 

0 

0 

0 

19 

0 
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0 

20 

0 

0 

0 

21 
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60 

86 

22 
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96 

23 
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96 

24 

0 

0 

0 

25 

0 

0 

0 

26 

0 

0 
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27 

0 

0 
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28 

0 

0 
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30 
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Figure  7.3.6  Resources  Used  by  Trainee  Type  (Track) 
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48 
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Figure  7.3.8  Detailed  Delivery  Report 
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PMT  TRACK  TRAINEES 
26  27  28  29  30 

1976  0 0 0 0 0 
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1980  0 0 0 0 0 

1901  0 10  0 G 0 

1982  0 30  30  30  10 

1983  0 30  30  30  30 

1984  0 30  30  30  30 

1985  28  30  30  30  30 

1986  30  30  30  30  30 

1987  30  30  30  30  30 
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1989  30  30  30  30  30 
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<== 

i 

TRACK  ==> 

L 

YEAR 

1 

2 

3 

4 

1976 

0 

0 

0 

0 

1977 

0 

0 

0 

0 

1976 

0 

0 

0 

o 

1979 

0 

0 

0 

o 

1980 

0 

0 

0 

o 

1981 

0 

10 

0 

0 

1982 
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12 

78 
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1983 

2 

12 

85 

0 

1984 

20 

12 

94 

0 
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1985 

39 

12 

96 

8 

1966 

58 

12 

20 

1987 

78 

12 

26 

1988 
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12 

27 

1989 
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27 

[ 

1990 
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12 

27 
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-=>  RESOURCE  USE 

A 

11 

II 

II 

i 

l - , 

RESOURCE 

:=> 

YEAR 

BRIEF  ROOM 

CARREL-GP 

DEVICE  ONE 

B-l  AIRCET 

1976 

0 

0 

0 

0 

1977 

0 

0 

0 

0 

1978 

0 

0 

0 

0 

1979 

0 

0 

0 

0 

1980 

0 

0 

0 

1981 

1400 
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740 

193  2 

135  36 

19224 

7596 

1983 

14872 

21320 

8395 

198  A 

18688 

26628 

10942 

1985 

22956 
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13764 

1966 

12110 

20512 

7826 

1987 

15270 

27732 

10322 

1988 
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27964 

10413 

1989 
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27984 

10413 

1990 

15432 

27984 

1041? 

Figure  7.3.12  Resources  Used 
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7.4  DATA  MANAGEMENT 

Because  of  the  dynamic  data  flow  in  the  Phase  3 TRAM  Program,  the 
standard  FORTRAN  array  and  indexing  structures  are  inadequate  in  terms  of 
core  utilization  and  computational  efficiency. 

Most  of  the  information  used  by  the  program  is  grouped  into  blocks 
of  data  that  are  organized  using  singly-linked  lists.  This  method  makes  it 
possible  to  add  and  delete  blocks  to  the  lists  without  a need  for  periodic 
reorganization. 

The  procblocs,  task  blocks,  resource  utilization  blocks  (RUBS)  and 
resource  utilization  description  blocks  (RUDBS)  share  a common  pool  of  storage 
in  common  BLKS  and  are  accessed  directly  by  their  addresses.  Subroutine 
BLOCK  is  used  to  copy  any  of  these  blocks  into  local  storage. 
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PERIODIC  REPORT 


</>  u ooooooooo 

8 5 
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2-5 
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I MMMMMMM 


|Mi| 


INPUT  PARAMETERS 


START  TIME  10 

END  TIME 

PERIODIC  REPORTING  PERIOO  2 

NUMBER  OF  CALENDAR  UNITS  PER  YEAR  8 


Jj 

L 

u 

o 

D 

D 

D 

D 
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7.5  REPORTS 


Sample  outputs  are  contained  on  the  following  pages.  The  reports 

1.  Parameters  - The  first  2 cards 

2.  Air  Base  List  - Base  names,  indices,  and  PMT  track  lists 

3.  Delivery  List  - Years  by  bases 

4.  CCTS  Track  List  - Sources  index  for  each  CCTS  track 

5.  Source  Availability  - Trainees  available  years  by  sources 

6.  Resource  Use  Data  - Resources  used  by  unit  trainees  - 
tracks  by  resources 

7.  CCTS  Summary  - Yearly  A/C  deliveries,  total  A/C  deployment 
new  crews,  replacement  crews,  total  crews  in  the  system 

pilot  upgrades,  total  full  crew  training,  and  extras  pairs 
training  1 

8.  Detailed  Base  Delivery  List 

9.  PMT  Track  Trainees  - Number  of  PMT  unit  trainees  per  track 

years  by  track  ' 

10.  Source  Use  Matrix  - Use  of  trainees  from  each  source,  years 

by  source  1 

11.  Track  Use  - Trainees  taught  by  years  and  track 

12.  Resource  Use  - Resources  used,  years  by  resource. 


7.6  DATA  SET  OUTPUT 

Two  files  are  produced. 

FORTRAN  Unit  1 contains  resource  use  records.  The  records  must  be 
sorted  by  date  and  resources  number.  Each  logical  record  contains 

• Date  in  CUs 

• Resource  number 

• Resource  originally  available 

• Resource  remaining. 

The  resource  originally  available  is  nominal  Jy^og  units.  A final  record  with 
the  time  999999  is  produced  as  an  end  of  file  record. 
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1 Number  of  resources 

2 Resource  names 

3 Number  of  calendar  units  per  year 

4 Bucket  size  for  each  resource  (=NCU  for  TROLIE) 


* 


I 

A 


Table  7.4,1 
Table  1 

TR0L1E  INPUT  DATA 


Card  or 


Cols. 

or  Variable 


9-20  NAB  Alphanumeric 

(Normally  only  Cols.  11 


Outputs 

Air  Base  Names 
-20  are  used) 


4A 

4012 

4012 

ILTID 

IUTID 

Integer 

Integer 

Lower  PMT  Track 
ID  Pointer 

Upper  PMT  Track 
ID  Pointer 

4B 

4012 

IDT 

Integer 

Track  ID  List 
(2  cards) 

5A 

1-4 

A 

Alphabetic 

"DELI"  (Cards 
normally  read 
DELIVERY) 

9-20 

MAB 

Alphabetic 

* 

Air  Base  Name 

31-35 

36-40 

IDTCU 

NACS 

Integer 

Integer 

cu 

Delivery  Date 

Number  of  Air- 
craft Delivered 

♦Normally,  only  Cols  11-20  are  used. 


HlifM  '1 


Jt'  „ . _W-  g,  J It! 


format 

Name 

Type 

Units 

Definition 

Note 

1-10 

AR 

Real 

Crew/Year 

Attrition  Ratio 

11-21 

CR 

Real 

Crew/A-C 

Crew  Ratio 

21-30 

PUPR 

Real 

Copilot^/year 

Copilot  Upgrade 
Ratio 

1-5 

NY 

Integer 

Years 

Total  Time 

£ 24 

6-10 

NY0 

Integer 

Years 

First  Year  Date 

11-15 

NB 

Integer 

No.  Air  Bases 

C 15 

16-20 

NS 

Integer 

No.  Sources 

^25 

21-25 

NT 

Integer 

No.  Tracks 

4.40 

26-30 

NR 

Integer 

No.  Resources 

C 80 

31-35 

NCU 

Integer 

CUs/year 

No.  Calendar 
Units/year 

£.  3 

36-40 

IDELAY 

Integer 

Years 

Delay  before 
Attrition 

41-45 

ITAPE 

Integer 

I/O 

Non-Zero  Inhibits 

(NB 

cards) 


IDT(I)>  25 
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Table  7.4.1  (continued) 


Cols. 

Card  or  or  Variable 
Card  Set  Format  Name 


IX£e 


Units 


SB 

1-4 

A 

Alphabetic 

6 

4012 

I STAB 

Integer 

7 

L 

2014 

NSPSY 

Integer 

I 

I 

8 

A10 

RESNAM 

Alphabetic 

9 

2014 

IRCPRT 

Integer 

r— •- 


Definition 


Notes 


"END 

Source  List 


Trainer  Sources 
Available 


1 Card 
per  year 
unless 
20  < NSS25 


Resource  Names  (1  per  card) 


Resource  use 
per  Unit  Class 


(1  or  more 
cards  per 
track,  new 
card  for 
each  track) 


I 

1 


I 


I 

I 


I 


Notes  on  Preparation  of  Inputs 


The  only  complex  input  is  card  set  4 consisting  of  the  array  IDT 
and  its  pointer  arrays  ILTID  and  IUTJD. 

These  inputs  are  most  conveniently  created  by  first  making  a list 
of  the  tracks  which  are  to  be  used  for  PMT  at  each  airbase.  For  example. 


Base  1 

PMT  Tracks  26,  27 


Base  2 
2S  ,27 


Base  3 
29,  30,  31 


The  Table  IDT  and  the  arrays  ILTID  and  IUTID  could  be  coded 


ILTID 

IUTID 


(Base  1) 


r\ 

26  27 


(Base  2) 


r\ 

28  27 


(Base  3) 


29  50  31 


Base  1 PMT  Base  2 PMT  Base  3 PMT 


Or  one  could  code 


ILTID 

IUTID 


/ 

,26  2 


Base  '2  PMT 


Base  1 PMT 


Base  3 PMT 
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8 VARIABLE  DIMENSIONS 

8.1  VARY  PROGRAM  AND  ASSOCIATED  CODE 

the  arravs^ffif  'l™  J66"  arranSed  t0  allow  the  “ser  to  re-dimension 

I®  to  fit  a particular  training  system.  This  becomes  important  when 

core  storage  is  limited,  since  one  may  be  forced  to  give  up  core  not  needed 

Particulaii?LSpha^n^0r>r-t0  aC“'”odate  a"  increased  number  of  classes, 
few  « Hocks  ’ “ cu,nberso"e  l°  cha"SC  the  dimensions  in  even  a 

« u The  idea  in  the  variable  dimension  option  is  as  follows:  Replace 

each  common  block  in  each  subroutine  with  ones  having  machine-recognizable 
key symbols  instead  of  dimensions.  The  source  code  then  becomes  a master  deck 

nlareWhthh  r 6dl^1llg  ?tep  (tbe  VARY  Pr°gram)  is  performed.  This  step  re- 
ricn?t-  he  k®ysymbolf  in  the  dimension  statements  by  numerical  values.  The 

into  6 may  6n  be  COmPiled-  The  Possibility  of  errors  introduced 

into  the  dimension  statements  is  thereby  reduced  to  the  problem  of  correctly 
specifying  the  value  of  the  keysymbols.  Y 

thrni , . The  vardable  dimension  feature  of  the  TRAM  program  is  implemented 

V USe  °V  !Xt  maniPulaticn  Program  VARY.  VARY  processes  FORTRAN 

sio^s  to  be  mndi'f • H triable  dimensions.  Statements  containing  dimen- 
sions to  be  modified  are  indicated  by  an  "X"  in  Column  1.  The  program 

1ooksHfn  f°r  un  tHe  inpUt  data  CardS-  Finding  such  a card,  it  then 

looks  for  special  character  strings  of  the  form  #vwv  where  vwv  is  a 3-  or 

-character  name.  The  length  of  the  name  indicates  maximum  reasonable  value 
for  the  variable.  A 4-character  name  (#PTA)  has  a limit  of  9999,  a 5-charac- 
ter name  (#CHKP)  has  the  limit  99999.  A table  is  supplied  to  the  VARY  program 
which  gives  the  dimension  desired  for  variables  with  a given  character  String 
For  example,  #CHKP  could  be  defined  to  be  1500  as  it  would  be  in  the  fixed  8’ 
dimension  program.  (Sec  Table  8.1.1.)  6 

8.2  INPUTS  TO  THE  VARY  PROGRAM 

a rnTitmi  are  th?fe  SetS  °f  input  data  for  VARY-  The  inPut  consists  of 

fn  a?’^rary  number  of  ^Pysymbol  cards,  and  the  source  code 

to  be  modified  (See  Table  8.1.2.) 


TABLE  8.1.1 


VARY  PARAMETERS  FOR  VPHASE3 


#RSRTS 
# BUCKS 

#CRSP1 

#PTBS 

#CG 

#CIN 

#TRKS 

#RLTDB 

#CRSEl 

#CRSES 

#LMIT1 

#LMITC 

#TDF1C 

#CLASS 

#CCLS 

#STSKS 

#PBLKS 

#CBSZE 

#TRESB 

#RES 

#SRCES 


max.  number  of  resources  needed  to  satisfy  any  RUB. 

max.  number  of  buckets  needed  for  1 primary  resource  and  associated 
second  aries. 

max.  number  of  courses  + 1. 

dimension  of  linked  storage  for  predetermined  transfer  block. 

max.  number  of  course  groups. 

max.  number  of  courses  in  a course  group. 

max.  number  of  tracks. 

max.  number  of  track  descriptor  blocks. 

max.  number  of  courses  +1  (synonym  for  #CRSP1) . 

max.  number  of  courses. 

dimension  of  linked  storage  for  training  demand  records. 

dimension  of  linked  storage  for  class  blocks. 

max.  number  of  track  descriptor  for  1 course. 

dimension  of  linked  storage  for  class  blocks  (synonym  for  #LM1T) 

max.  number  of  simultaneously  active  classes. 

max.  number  of  tasks  to  be  executed  simultaneously. 

max.  number  of  procblocs. 

number  of  words  in  classblock  (30) 

max.  number  of  resource  buckets  needed  to  do  resource  utilization 
tasks  for  a group  of  synchronized  classes. 

max.  number  of  resources. 

max.  number  of  sources. 
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Table  8.1.1  (continued) 

VARY  PARAMETERS  FOR  VCLOCK,  VNAMES  AND  VPHASE2 


#A 

- 

max.  number 

of 

air  bases. 

#E 

- 

max.  number 

of 

air  base  event  cards . 

#AC 

- 

max.  number 

of 

CCTS  cards. 

#PG 

- 

max.  number 

of 

PMT  group  cards . 

#PC 

- 

max.  number 

of 

PMT  course  cards . 

#AD 

- 

max.  number 

of 

air  base  delivery  cards. 

#AB 

- 

max.  number 

of 

air  base  buckets. 

#Y 

- 

max.  number 

of 

years. 

#CR 

- 

max.  number 

of 

courses  (CCTS  + PMT) . 

#BLKS 

- 

number  of  words 

; in  pool  of  storage  for  PROC,TASK 

#NAM 

- 

max.  number 

of 

names  in  pool  of  names . 

#RS 

- 

max.  number 

of 

resources . 

#RC 

- 

max.  number 

of 

resource  cards . 

#SR 

- 

max.  number 

of 

sources . 

#SC 

- 

max . number 

of 

source  cards . 

#RPL 

- 

max.  number 

of 

resources  in  pool  of  resources. 

#SPL 

- 

max.  number 

of 

sources  in  pool  of  sources . 

#STK 

max.  size  of  stack. 
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TABLE  8.1.2 

CONTROL  CARD  (Format  615,  10AI) 


Variable 

Value 

Definition 

IPRINT 

0/1 

No/yes  prints  copy  of 
modified  deck 

IPUNCH 

0/0 

No/yes  punches  copy  of 
modified  deck 

IUNIT 

1-99/6,7 

Unit  used  for  source  input 

I0UT 

1-99/5,6 

Unit  used  for  deck  output 

NC0LS 

72  (typical) 

Columns  to  check 

L0KEY 

1 (typical) 

Column  location  of  flag  for 
modifiable  card 

ICHG 

X (typical) 

Flag  for  modifiable  card 

IC0DE 

# (typical) 

First  character  of  keysymbol 

10 

19 

0 

9 

Numeric  character  references 

ICOMM 

IRPAR 

ILPAR 

IREPLC 

ISLSH 

9 

) 

( 

blank 

/ 

Alphanumeric  characters 
reference 

Keysymbol 

Cards  (Format 

80AI) 

KEY 

d-6) 

Keysymbol 

I KEY 

(7-12) 

Keysymbol 

replacement 

COMENT  (13-80) 

END  Card  (Columns  1-3) 

Arbitrary  comment 

The  source  code  is  found  on  Unit  IUNIT  and  the  output  is  placed 
on  Unit  I0UT. 
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